Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

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.

Repozytorium
stacc ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 21.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Non-interactive first
  2. Discoverability without dumping context
  3. --help that works
  4. stdin, flags, and pipelines
  5. Fail fast with actionable errors
  6. Idempotency
  7. Destructive actions
  8. Predictable structure
  9. Success output
  10. When reviewing an existing CLI
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 440 słów
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

RepozytoriumWynikLicencja
Ta strona · heyAyushh/stacc100MIT
OutlineDriven/outline-driven-development100Apache-2.0
pproenca/dot-skills100MIT
v1truv1us/ai-eng-system100MIT
v1truv1us/ai-eng-system100MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.