CommunityCodierung & Entwicklunggithub.com

steipete/create-cli

CLI-UX/Spezifikation: Argumente, Flags, Hilfe, Ausgabe, Fehler, Konfiguration, Probelauf.

Was ist create-cli?

Dieses Skill definiert einen strukturierten und menschenzentrierten Ansatz für das Design von CLI-Oberflächen (Befehlszeilenschnittstellen). Es konzentriert sich auf eine klare Syntax, konsistentes Verhalten und Benutzerfreundlichkeit für sowohl menschliche Anwender als auch Skripte. Das Skill leitet den Agenten an, Minimalfragen zu stellen, um die Schnittstelle festzulegen, und dann eine kompakte Spezifikation auszugeben, die der Benutzer implementieren kann. Es umfasst Aspekte wie Befehlshierarchie, Argumente und Flags, Ausgabeverträge, Fehler- und Exit-Codes sowie Sicherheitsregeln wie `--dry-run` und Bestätigungen. Das Skill ist sprachunabhängig und verweist auf die anerkannten CLI-Richtlinien von clig.dev als Standard-Rubrik. Es unterstützt alle Plattformen (macOS/Linux/Windows) und kann für einzelne Binärdateien oder Laufzeitumgebungen konfiguriert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/create-cli

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

CLI erstellen

Entwerfen Sie die CLI-Oberfläche (Syntax + Verhalten), zuerst für Menschen, aber skriptfreundlich.

Zuerst erledigen

  • Lesen Sie agent-scripts/skills/create-cli/references/cli-guidelines.md und wenden Sie es als Standard-Rubrik an.
  • Übergeordnete/vollständige Richtlinien: https://clig.dev/ (Änderungen vorschlagen: https://github.com/cli-guidelines/cli-guidelines)
  • Stellen Sie nur die minimal notwendigen Klarheitsfragen, um die Schnittstelle festzulegen.

Klären (schnell)

Fragen Sie, und fahren Sie dann mit Standardannahmen fort, wenn der Benutzer unsicher ist:

  • Befehlsname + Satz mit Zweck.
  • Hauptbenutzer: Menschen, Skripte oder beides.
  • Eingabequellen: Argumente vs. stdin; Dateien vs. URLs; Geheimnisse (niemals über Flags).
  • Ausgabevertrag: Text für Menschen, --json, --plain, Exit-Codes.
  • Interaktivität: Eingabeaufforderungen erlaubt? --no-input erforderlich? Bestätigungen bei destruktiven Operationen?
  • Konfigurationsmodell: Flags/Umgebung/Konfigurationsdatei; Rangfolge; XDG vs. repo-lokal.
  • Plattform-/Laufzeitbeschränkungen: macOS/Linux/Windows; einzelne Binärdatei vs. Laufzeit.

Liefergegenstände (was auszugeben ist)

Erstellen Sie beim Entwerfen einer CLI eine kompakte Spezifikation, die der Benutzer implementieren kann:

  • Befehlshaum + SYNOPSIS der Verwendung.
  • Tabelle mit Argumenten/Flags (Typen, Standardwerte, erforderlich/optional, Beispiele).
  • Semantik der Unterbefehle (was jeder tut; Idempotenz; Statusänderungen).
  • Ausgaberegeln: stdout vs. stderr; TTY-Erkennung; --json/--plain; --quiet/--verbose.
  • Fehler- + Exit-Code-Zuordnung (häufigste Fehlermodi).
  • Sicherheitsregeln: --dry-run, Bestätigungen, --force, --no-input.
  • Konfigurations-/Umgebungsregeln + Rangfolge (flags > umgebung > projektkonfiguration > benutzerkonfiguration > system).
  • Shell-Vervollständigungsgeschichte (falls zutreffend): Installation/Auffindbarkeit; Generierungsbefehl oder gebündelte Skripte.
  • 5–10 Beispielaufrufe (häufige Abläufe; Beispiele mit Pipe/stdin einschließen).

Standardkonventionen (sofern der Benutzer nichts anderes sagt)

  • -h/--help zeigt immer Hilfe an und ignoriert andere Argumente.
  • --version gibt die Version auf stdout aus.
  • Primäre Daten auf stdout; Diagnosen/Fehler auf stderr.
  • Fügen Sie --json für Maschinenausgabe hinzu; erwägen Sie --plain für stabile zeilenbasierte Textausgabe.
  • Eingabeaufforderungen nur, wenn stdin ein TTY ist; --no-input deaktiviert Eingabeaufforderungen.
  • Destruktive Operationen: interaktive Bestätigung + nicht-interaktiv erfordert --force oder explizites --confirm=....
  • Respektieren Sie NO_COLOR, TERM=dumb; stellen Sie --no-color bereit.
  • Ctrl-C behandeln: schnell beenden; begrenzte Bereinigung; wenn möglich nur auf Absturz ausgelegt.

Vorlagen (in Ihre Antwort kopieren)

CLI-Spezifikationsgerüst

Füllen Sie diese Abschnitte aus, entfernen Sie alles Unwichtige:

  1. Name: mycmd
  2. Einzeiler: ...
  3. VERWENDUNG:
    • mycmd [globale Flags] <unterbefehl> [argumente]
  4. Unterbefehle:
    • mycmd init ...
    • mycmd run ...
  5. Globale Flags:
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose (genau definieren)
    • --json / --plain (falls zutreffend)
  6. I/O-Vertrag:
    • stdout:
    • stderr:
  7. Exit-Codes:
    • 0 Erfolg
    • 1 allgemeiner Fehler
    • 2 ungültige Verwendung (Parse-/Validierungsfehler)
    • (fügen Sie befehlsspezifische Codes nur hinzu, wenn sie tatsächlich nützlich sind)
  8. Umgebung/Konfiguration:
    • Umgebungsvariablen:
    • Konfigurationsdateipfad + Rangfolge:
  9. Beispiele:
    • …

Hinweise

  • Bevorzugen Sie die Empfehlung einer Parsing-Bibliothek (sprachspezifisch) nur auf Nachfrage; andernfalls halten Sie dieses Skill sprachunabhängig.
  • Wenn die Anfrage „Parameter entwerfen“ lautet, nicht in die Implementierung abdriften.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Verwandte Skills