Agent CLI

Converteert Python CLI's naar agent-consumeerbare --json NDJSON met een gedeelde hulpbibliotheek

Door glebis · glebis/claude-skills

Getest · Werkt ★ 9.2/10

Agent CLI — Converteert Python CLI's naar agent-consumeerbare --json NDJSON met een gedeelde hulpbibliotheek

Wat het doet

Voegt een agent-vriendelijke --json NDJSON uitvoermodus toe aan Python CLI-scripts, waarbij print statements worden omgezet in gestructureerde, getimede JSON-events achter één modusvlag, of genereert een distribueerbaar cli_utils-pakket met tests en CI. Activeert wanneer de gebruiker machineleesbare CLI-uitvoer voor AI-agents wil, vraagt om een --json vlag toe te voegen, NDJSON of gestructureerde CLI-uitvoer noemt, of een CLI-hulpbibliotheek wil bouwen. Levert een referentie cli_utils.py implementatie, stap-voor-stap conversiepatronen en een voltooiingschecklist.

Testrapport

SKILL.md en beide gerefereerde bestanden (best-practices.md en evals.json beide HTTP 200) opgehaald. Een argparse CLI voor alleen mensen geschreven, vervolgens een BASELINE conversie geproduceerd (naïeve inline json.dumps met ad-hoc sleutels, geen tijdstempels, een as_json parameter door elke functie geleid) en een SKILL conversie (de referentie cli_utils.py letterlijk gekopieerd en de patronen van Stap 1-4 toegepast). Beide werden uitgevoerd. Concreet verschil: skill-uitvoer zendt een uniforme envelop {"event","ts",...} uit op elke regel met ISO-tijdstempels en een correcte {"event":"error"} op het foutpad plus exit 1, terwijl baseline-regels inconsistente vormen ("status"/"attempt"/"error") en geen tijdstempels bevatten; ik bevestigde dat elke skill JSON-regel als NDJSON parseert, de menselijke modus automatisch behouden blijft via de globale vlag, en --json verschijnt in --help. Ik heb ook de eigen meegeleverde pytest-asserties van de skill voor json_log en die uitgevoerd tegen cli_utils.py — beide slaagden. Geen beveiligingsrisico's (geen curl|sh, base64 of eval).

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

Installatie

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.

Commando's en voorbeeldprompts

  • /agent-cliConverteert Python CLI's naar agent-consumeerbare --json NDJSON met een gedeelde hulpbibliotheek

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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