SkillProof tested Claude skills

Agent CLI

Převádí Python CLIs na agentem konzumovatelné --json NDJSON se sdílenou pomocnou knihovnou

od glebis · glebis/claude-skills

Otestováno · Funguje ★ 9.2/10

Agent CLI — Převádí Python CLIs na agentem konzumovatelné --json NDJSON se sdílenou pomocnou knihovnou

Co umí

Přidává agentům přátelský výstupní režim --json NDJSON do Python CLI skriptů, převádí print statements na strukturované, časově označené JSON události za jediným přepínačem režimu, nebo scaffolduje distribuovatelný balíček cli_utils s testy a CI. Spouští se, když uživatel chce strojově čitelný CLI výstup pro AI agenty, požádá o přidání --json flagu, zmíní NDJSON nebo strukturovaný CLI výstup, nebo chce vytvořit pomocnou CLI knihovnu. Dodává referenční implementaci cli_utils.py, vzory krok za krokem pro konverzi a kontrolní seznam dokončení.

Testovací report

Načten SKILL.md a oba referenční soubory (best-practices.md a evals.json, oba HTTP 200). Napsán argparse CLI pouze pro člověka, poté vytvořena BASELINE konverze (naivní inline json.dumps s ad-hoc klíči, bez časových značek, parametr as_json protažený každou funkcí) a SKILL konverze (zkopírován referenční cli_utils.py doslovně a aplikovány vzory Krok 1-4). Obě běžely. Konkrétní rozdíl: výstup skillu emituje jednotnou obálku {"event","ts",...} na každém řádku s ISO časovými značkami a správnou {"event":"error"} na chybové cestě plus exit 1, zatímco řádky baseline nesou nekonzistentní tvary ("status"/"attempt"/"error") a žádné časové značky; potvrdil jsem, že každý JSON řádek skillu se parsuje jako NDJSON, lidský režim je automaticky zachován pomocí globálního flagu a --json se objevuje v --help. Také jsem spustil vlastní poskytnuté pytest assertions skillu pro json_log a die proti cli_utils.py – obě prošly. Žádné bezpečnostní hrozby (žádné curl|sh, base64, nebo eval).

Testováno: 2026-07-31 · Claude Code 2.x (agent harness)

Instalace

git clone --depth 1 https://github.com/glebis/claude-skills.git /tmp/agent-cli-src
mkdir -p ~/.claude/skills
cp -R /tmp/agent-cli-src/agent-cli ~/.claude/skills/agent-cli
# SKILL.md is self-contained Python; no external deps to install.
# References bundled: references/best-practices.md, evals/evals.json
# Package-scaffold mode (Mode B) generates a project that needs pytest>=8 to run its test suite.

Příkazy a ukázkové prompty

  • /agent-cliPřevádí Python CLIs na agentem konzumovatelné --json NDJSON se sdílenou pomocnou knihovnou

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • Add a --json flag to this Python script
  • Convert these print statements to structured JSON
  • Scaffold a cli_utils package for this project

Kompletní testovací report (anglicky) →