SkillProof tested Claude skills

Agent CLI

Konverter Python CLI-er til agent-forbrukbar --json NDJSON med et delt hjelpebibliotek

av glebis · glebis/claude-skills

Bestått ★ 9.2/10

Agent CLI — Konverter Python CLI-er til agent-forbrukbar --json NDJSON med et delt hjelpebibliotek

Hva den gjør

Legger til en agent-vennlig --json NDJSON utdatamodus til Python CLI-skript, som konverterer print-setninger til strukturerte, tidsstemplede JSON-hendelser bak et enkelt modusflagg, eller stillaser en distribuerbar cli_utils-pakke med tester og CI. Utløses når brukeren ønsker maskinlesbar CLI-utdata for AI-agenter, ber om å legge til et --json-flagg, nevner NDJSON eller strukturert CLI-utdata, eller ønsker å bygge et CLI-hjelpebibliotek. Leverer en referanseimplementering av cli_utils.py, trinnvise konverteringsmønstre og en sjekkliste for fullføring.

Testrapport

Hentet SKILL.md og begge refererte filer (best-practices.md og evals.json begge HTTP 200). Skrev en argparse CLI kun for mennesker, produserte deretter en BASELINE-konvertering (naiv inline json.dumps med ad-hoc-nøkler, ingen tidsstempler, en as_json-parameter trådet gjennom hver funksjon) og en SKILL-konvertering (kopierte referansen cli_utils.py ordrett og anvendte trinn 1-4-mønstrene). Begge kjørte. Konkret forskjell: ferdighetsutdata sender ut en ensartet konvolutt {"event","ts",...} på hver linje med ISO-tidsstempler og en korrekt {"event":"error"} på feilbanen pluss exit 1, mens baseline-linjer har inkonsekvente former ("status"/"attempt"/"error") og ingen tidsstempler; jeg bekreftet at hver ferdighets-JSON-linje parses som NDJSON, menneskelig modus er automatisk bevart via det globale flagget, og --json vises i --help. Jeg kjørte også ferdighetens egne pytest-påstander for json_log og die mot cli_utils.py – begge besto. Ingen sikkerhetsbrudd (ingen curl|sh, base64 eller eval).

Testet på: 2026-07-31 · Claude Code 2.x (agent harness)

Installer

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-forbrukbar --json NDJSON med et delt hjelpebibliotek

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →