SkillProof tested Claude skills

Agent CLI

Convierte CLIs de Python a --json NDJSON consumibles por agentes con una biblioteca de ayuda compartida

Por glebis · glebis/claude-skills

Probado · Funciona ★ 9.2/10

Agent CLI — Convierte CLIs de Python a --json NDJSON consumibles por agentes con una biblioteca de ayuda compartida

Qué hace

Añade un modo de salida --json NDJSON amigable para agentes a scripts CLI de Python, convirtiendo las sentencias `print` en eventos JSON estructurados y con marca de tiempo detrás de un único indicador de modo, o estructura un paquete `cli_utils` distribuible con pruebas y CI. Se activa cuando el usuario desea una salida CLI legible por máquina para agentes de IA, pide añadir un indicador --json, menciona NDJSON o salida CLI estructurada, o quiere construir una biblioteca de ayuda CLI. Incluye una implementación de referencia `cli_utils.py`, patrones de conversión paso a paso y una lista de verificación de finalización.

Informe de la prueba

Se obtuvo SKILL.md y ambos archivos referenciados (best-practices.md y evals.json, ambos HTTP 200). Se escribió un CLI `argparse` solo para humanos, luego se produjo una conversión BASELINE (json.dumps en línea ingenuo con claves ad-hoc, sin marcas de tiempo, un parámetro `as_json` pasado a través de cada función) y una conversión SKILL (se copió `cli_utils.py` de referencia textualmente y se aplicaron los patrones de los Pasos 1-4). Ambos se ejecutaron. Diferencia concreta: la salida de la habilidad emite un sobre uniforme {"event","ts",...} en cada línea con marcas de tiempo ISO y un {"event":"error"} adecuado en la ruta de error más `exit 1`, mientras que las líneas de referencia tienen formas inconsistentes ("status"/"attempt"/"error") y sin marcas de tiempo; confirmé que cada línea JSON de la habilidad se analiza como NDJSON, el modo humano se conserva automáticamente mediante el indicador global, y --json aparece en --help. También ejecuté las propias aserciones `pytest` proporcionadas por la habilidad para `json_log` y `die` contra `cli_utils.py` — ambas pasaron. Sin problemas de seguridad (sin `curl|sh`, `base64` o `eval`).

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

Instalación

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.

Comandos y prompts de ejemplo

  • /agent-cliConvierte CLIs de Python a --json NDJSON consumibles por agentes con una biblioteca de ayuda compartida

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →