SkillProof tested Claude skills

Agent CLI

Konwertuj Python CLI na --json NDJSON konsumowalne przez agentów za pomocą współdzielonej biblioteki pomocniczej

Autor: glebis · glebis/claude-skills

Testowano · Działa ★ 9.2/10

Agent CLI — Konwertuj Python CLI na --json NDJSON konsumowalne przez agentów za pomocą współdzielonej biblioteki pomocniczej

Co robi ten skill

Dodaje przyjazny dla agentów tryb wyjścia --json NDJSON do skryptów Python CLI, konwertując instrukcje print na ustrukturyzowane, ostemplowane czasowo zdarzenia JSON za pojedynczą flagą trybu, lub tworzy szkielet pakietu cli_utils z testami i CI. Uruchamia się, gdy użytkownik chce maszynowo czytelnych danych wyjściowych CLI dla agentów AI, prosi o dodanie flagi --json, wspomina o NDJSON lub ustrukturyzowanych danych wyjściowych CLI, lub chce zbudować bibliotekę pomocniczą CLI. Dostarcza referencyjną implementację cli_utils.py, wzorce konwersji krok po kroku oraz listę kontrolną ukończenia.

Raport z testu

Pobrano SKILL.md i oba odwołujące się pliki (best-practices.md i evals.json, oba HTTP 200). Napisano argparse CLI tylko dla ludzi, następnie wygenerowano konwersję BASELINE (naiwne wbudowane json.dumps z ad-hoc kluczami, bez znaczników czasu, parametr as_json przekazywany przez każdą funkcję) oraz konwersję SKILL (skopiowano referencyjny cli_utils.py dosłownie i zastosowano wzorce Kroków 1-4). Oba działały. Konkretna różnica: wyjście umiejętności emituje jednolitą kopertę {"event","ts",...} w każdej linii z znacznikami czasu ISO i właściwym {"event":"error"} na ścieżce błędu plus exit 1, podczas gdy linie bazowe mają niespójne kształty ("status"/"attempt"/"error") i brak znaczników czasu; potwierdziłem, że każda linia JSON umiejętności jest parsowana jako NDJSON, tryb ludzki jest automatycznie zachowany przez globalną flagę, a --json pojawia się w --help. Uruchomiłem również własne asercje pytest umiejętności dla json_log i die przeciwko cli_utils.py — oba przeszły. Brak zagrożeń bezpieczeństwa (brak curl|sh, base64 lub eval).

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

Instalacja

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.

Komendy i przykładowe prompty

  • /agent-cliKonwertuj Python CLI na --json NDJSON konsumowalne przez agentów za pomocą współdzielonej biblioteki pomocniczej

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →