cli-for-agents
/cli-for-agents
Projektuje lub przegląda CLI tak, by agenci kodujący mogli je niezawodnie uruchamiać: flagi nieinteraktywne, warstwowy --help z przykładami, stdin i potoki, szybkie błędy, idempotencja i dry-run.
- Autor
- heyAyushh ↗
- Repozytorium
- stacc ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 21.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 21.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Projektuje lub przegląda CLI tak, by agenci kodujący mogli je niezawodnie uruchamiać: flagi nieinteraktywne, warstwowy --help z przykładami, stdin i potoki, szybkie błędy, idempotencja i dry-run.
Oryginalny opis (EN)
Designs or reviews CLIs so coding agents can run them reliably: non-interactive flags, layered --help with examples, stdin/pipelines, fast actionable errors, idempotency, dry-run, and predictable structure. Use when building a CLI, adding commands, writing --help, or when the user mentions agents, terminals, or automation-friendly CLIs.
Jak działa
- Non-interactive first
- Discoverability without dumping context
- --help that works
- stdin, flags, and pipelines
- Fail fast with actionable errors
- Idempotency
- Destructive actions
- Predictable structure
- Success output
- When reviewing an existing CLI
Podgląd SKILL.md
--- name: cli-for-agents description: >- Designs or reviews CLIs so coding agents can run them reliably: non-interactive flags, layered --help with examples, stdin/pipelines, fast actionable errors, idempotency, dry-run, and predictable structure. Use when building a CLI, adding commands, writing --help, or when the user mentions agents, terminals, or automation-friendly CLIs. license: MIT --- # CLI for agents Human-oriented CLIs often block agents: interactive prompts, huge upfront docs, and help text without copy-pasteable examples. Prefer patterns that work headlessly and compose in pipelines. ## Non-interactive first - Every input should be expressible as a flag or flag value. Do not require arrow keys, menus, or timed prompts. - If flags are missing, **then** fall back to interactive mode—not the other way around. **Bad:** `mycli deploy` → `? Which environment? (use arrow keys)` **Good:** `mycli deploy --env staging` ## Discoverability without dumping context - Agents discover subcommands incrementally: `mycli`, then `mycli deploy --help`. Do not print the entire manual on every run. - Let each subcommand own its documentation so unused commands stay out of context. - If the CLI needs extensive agent guidance, keep the default skill/help thin and point to versioned, CLI-served instructions. See `references/agent-browser-runtime-skills.md`. ## `--help` that works - Every subcommand has `--help`. - Every `--help` includes **Examples** with real invocations. Examples do more than prose for pattern-matching. ```text Options: --env Target environment (staging, production) --tag Image tag (default: latest) --force Skip confirmation Examples: mycli deploy --env staging mycli deploy --env production --tag v1.2.3 mycli deploy --env staging --force ``` ## stdin, flags, and pipelines - Accept stdin where it makes sense (e.g. `cat config.json | mycli config import --stdin`). - Avoid odd positional ordering and avoid falling back to interactive prompts for missing values. - Support chaining: `mycli deploy --env staging --tag $(mycli build --output tag-only)`. ## Fail fast with actionable errors - On missing required flags: exit immediately with a clear message and a **correct example invocation**, not a hang. ```text Error: No image tag specified. mycli deploy --env staging --tag <image-tag> Available tags: mycli build list --output tags ``` ## Idempotency - Agents retry often. The same successful command run twice should be safe (no-op or explicit "already done"), not duplicate side effects. ## Destructive actions - Add `--dry-run` (or equivalent) so agents can preview plans before committing. - Offer `--yes` / `--force` to skip confirmations while keeping the safe default for humans. ## Predictable structure - Use a consistent pattern everywhere, e.g. `resource` + `verb`: if `mycli service list` exists, `mycli deploy list` and `mycli config list` should follow the same shape. ## Success output - On success, return machine-useful data: IDs, URLs, durations. Plain text is fine; avoid relying on decorative output alone. ```text deployed v1.2.3 to staging url: https://staging.myapp.com deploy_id: dep_abc123 duration: 34s ``` ## When reviewing an existing CLI - Check: non-interactive path, layered help, examples on `--help`, stdin/pipeline story, error messages with invocations, idempotency, dry-run, confirmation bypass flags, consistent command structure, structured success output.
Pliki w paczce (3)
- LICENSE.txt 1 KB
- SKILL.md 3 KB
- references/agent-browser-runtime-skills.md 2 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · heyAyushh/stacc | 100 | MIT |
| OutlineDriven/outline-driven-development | 100 | Apache-2.0 |
| pproenca/dot-skills | 100 | MIT |
| v1truv1us/ai-eng-system | 100 | MIT |
| v1truv1us/ai-eng-system | 100 | MIT |
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 69794c52ee4d (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95cli-for-agent
Projektuje lub przegląda CLI przyjazne agentom: flagi bez interakcji, pomoc z przykładami, potoki, czytelne błędy i tryb dry-run. - 100cli-builder
Buduje lub refaktoryzuje narzędzia CLI dla agentów: polecenia nieinteraktywne, stabilne kontrakty --help i --json, operacje idempotentne i podglądy --dry-run. - 100cli-agent-friendly-audit
Audytuje narzędzie CLI według listy kontrolnej przyjazności dla agentów z tekstu Zbigniewa Sobieckiego „Building Agent-Friendly CLIs”, oceniając ergonomię dla agentów. - 100agent-dx-cli
Projektuje, sprawdza i przerabia CLI dla agentów AI: przewidywalność, obronę w głąb i zwięzłość kontekstu, z ocenami na podstawie dowodów. - 100create-cli
Projektuje interfejs wiersza poleceń: argumenty, flagi, podkomendy, pomoc, formaty wyjścia, błędy, kody wyjścia, konfigurację i tryb dry-run. - 100creating-cli-tools
Projektuje interfejs wiersza poleceń: argumenty, flagi, podkomendy, pomoc, formaty wyjścia, błędy, kody wyjścia, konfigurację i tryb dry-run.