SkillProof tested Claude skills

Agent CLI

Konvertera Python CLI:er till agent-konsumerbar --json NDJSON med ett delat hjälparbibliotek

av glebis · glebis/claude-skills

Testad · Fungerar ★ 9.2/10

Agent CLI — Konvertera Python CLI:er till agent-konsumerbar --json NDJSON med ett delat hjälparbibliotek

Vad den gör

Lägger till ett agentvänligt --json NDJSON-utdataläge till Python CLI-skript, konverterar print-satser till strukturerade, tidsstämplade JSON-händelser bakom en enda lägesflagga, eller stöder ett distribuerbart cli_utils-paket med tester och CI. Utlöses när användaren vill ha maskinläsbar CLI-utdata för AI-agenter, ber att lägga till en --json-flagga, nämner NDJSON eller strukturerad CLI-utdata, eller vill bygga ett CLI-hjälparbibliotek. Levererar en referensimplementering av cli_utils.py, steg-för-steg-konverteringsmönster och en checklista för slutförande.

Testrapport

Hämtade SKILL.md och båda refererade filerna (best-practices.md och evals.json båda HTTP 200). Skrev en argparse CLI endast för människor, producerade sedan en BASELINE-konvertering (naiv inline json.dumps med ad-hoc-nycklar, inga tidsstämplar, en as_json-parameter genom varje funktion) och en SKILL-konvertering (kopierade referensen cli_utils.py ordagrant och tillämpade steg 1-4-mönstren). Båda kördes. Konkret skillnad: skill-utdata avger ett enhetligt kuvert {"event","ts",...} på varje rad med ISO-tidsstämplar och ett korrekt {"event":"error"} på felvägen plus exit 1, medan baseline-rader har inkonsekventa former ("status"/"attempt"/"error") och inga tidsstämplar; jag bekräftade att varje skill JSON-rad parsas som NDJSON, mänskligt läge bevaras automatiskt via den globala flaggan, och --json visas i --help. Jag körde också skillens egna pytest-assertioner för json_log och die mot cli_utils.py – båda godkändes. Inga säkerhetsbrister (inga curl|sh, base64 eller eval).

Testad: 2026-07-31 · Claude Code 2.x (agent harness)

Installation

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.

Kommandon och exempelprompter

  • /agent-cliKonvertera Python CLI:er till agent-konsumerbar --json NDJSON med ett delat hjälparbibliotek

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →