SkillProof tested Claude skills

Agent CLI

Konvertiert Python CLIs in agenten-konsumierbares --json NDJSON mit einer gemeinsamen Hilfsbibliothek

von glebis · glebis/claude-skills

Getestet · Funktioniert ★ 9.2/10

Agent CLI — Konvertiert Python CLIs in agenten-konsumierbares --json NDJSON mit einer gemeinsamen Hilfsbibliothek

Was es kann

Fügt Python CLI-Skripten einen agentenfreundlichen --json NDJSON-Ausgabemodus hinzu, der print-Anweisungen in strukturierte, zeitgestempelte JSON-Ereignisse hinter einem einzigen Modus-Flag umwandelt, oder gerüstet ein verteilbares cli_utils-Paket mit Tests und CI. Wird ausgelöst, wenn der Benutzer maschinenlesbare CLI-Ausgabe für KI-Agenten wünscht, bittet, ein --json-Flag hinzuzufügen, NDJSON oder strukturierte CLI-Ausgabe erwähnt oder eine CLI-Hilfsbibliothek erstellen möchte. Liefert eine Referenzimplementierung von cli_utils.py, Schritt-für-Schritt-Konvertierungsmuster und eine Checkliste zur Fertigstellung.

Testbericht

SKILL.md und beide referenzierten Dateien (best-practices.md und evals.json, beide HTTP 200) abgerufen. Eine reine argparse CLI für Menschen geschrieben, dann eine BASELINE-Konvertierung (naive inline json.dumps mit Ad-hoc-Schlüsseln, keine Zeitstempel, ein as_json-Parameter, der durch jede Funktion geleitet wird) und eine SKILL-Konvertierung (die Referenz cli_utils.py wörtlich kopiert und die Muster von Schritt 1-4 angewendet) erstellt. Beide liefen. Konkreter Unterschied: Die Skill-Ausgabe emittiert einen einheitlichen Umschlag {"event","ts",...} in jeder Zeile mit ISO-Zeitstempeln und ein korrektes {"event":"error"} auf dem Fehlerpfad plus exit 1, während Baseline-Zeilen inkonsistente Formen ("status"/"attempt"/"error") und keine Zeitstempel aufweisen; ich bestätigte, dass jede Skill-JSON-Zeile als NDJSON geparst wird, der menschliche Modus über das globale Flag automatisch erhalten bleibt und --json in --help erscheint. Ich habe auch die vom Skill bereitgestellten pytest-Assertions für json_log und die gegen cli_utils.py ausgeführt – beide bestanden. Keine Sicherheitsmängel (kein curl|sh, base64 oder eval).

Getestet am: 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.

Befehle & Beispiel-Prompts

  • /agent-cliKonvertiert Python CLIs in agenten-konsumierbares --json NDJSON mit einer gemeinsamen Hilfsbibliothek

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →