SkillProof tested Claude skills

Agent CLI

Konverter Python CLI'er til agent-forbrugbar --json NDJSON med et delt hjælpebibliotek

Af glebis · glebis/claude-skills

Testet · Virker ★ 9.2/10

Agent CLI — Konverter Python CLI'er til agent-forbrugbar --json NDJSON med et delt hjælpebibliotek

Hvad det gør

Tilføjer en agentvenlig --json NDJSON outputtilstand til Python CLI-scripts, der konverterer print-udsagn til strukturerede, tidsstemplede JSON-begivenheder bag et enkelt tilstandsflag, eller stilladserer en distribuerbar cli_utils-pakke med tests og CI. Udløses når brugeren ønsker maskinlæsbart CLI-output til AI-agenter, beder om at tilføje et --json-flag, nævner NDJSON eller struktureret CLI-output, eller ønsker at bygge et CLI-hjælpebibliotek. Leverer en referenceimplementering af cli_utils.py, trin-for-trin konverteringsmønstre og en tjekliste for fuldførelse.

Testrapport

Hentede SKILL.md og begge refererede filer (best-practices.md og evals.json begge HTTP 200). Skrev en argparse CLI kun til mennesker, producerede derefter en BASELINE-konvertering (naiv inline json.dumps med ad-hoc nøgler, ingen tidsstempler, en as_json-parameter trådet gennem hver funktion) og en SKILL-konvertering (kopierede reference cli_utils.py ordret og anvendte trin 1-4 mønstrene). Begge kørte. Konkret forskel: skill-output udsender en ensartet konvolut {"event","ts",...} på hver linje med ISO-tidsstempler og en korrekt {"event":"error"} på fejlvejen plus exit 1, hvorimod baseline-linjer har inkonsekvente former ("status"/"attempt"/"error") og ingen tidsstempler; jeg bekræftede, at hver skill JSON-linje parses som NDJSON, menneskelig tilstand bevares automatisk via det globale flag, og --json vises i --help. Jeg kørte også skill'ens egne pytest-assertions for json_log og die mod cli_utils.py — begge bestod. Ingen sikkerhedsbrister (ingen curl|sh, base64 eller eval).

Testet: 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.

Kommandoer og eksempelprompter

  • /agent-cliKonverter Python CLI'er til agent-forbrugbar --json NDJSON med et delt hjælpebibliotek

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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 hele rapporten →