steipete/create-cli

Especificações de UX/CLI: argumentos, flags, ajuda, saída, erros, configuração, simulação.

O que é create-cli?

Esta skill guia o design da superfície de linha de comando (CLI) com foco em humanos e scripts, seguindo as melhores práticas do clig.dev. Ela ajuda a definir rapidamente o nome, propósito, público-alvo (humanos, scripts ou ambos), fontes de entrada (args, stdin, arquivos, URLs), contrato de saída (texto humano, JSON, texto simples, códigos de saída) e modelo de configuração (flags, env, arquivo de configuração, precedência). A skill produz um conjunto de entregáveis como árvore de comandos, tabela de argumentos/flags, semântica de subcomandos, regras de saída, mapa de erros/códigos de saída, regras de segurança (dry-run, confirmações, force, no-Input) e até 10 exemplos de invocação. Ela é útil para qualquer pessoa projetando uma CLI em qualquer linguagem, fornecendo um modelo padronizado que economiza tempo e garante consistência. A skill suporta todas as plataformas (macOS, Linux, Windows) e é agnóstica a linguagem, recomendando bibliotecas de parsing apenas quando solicitado.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Criar CLI

Projete a superfície da CLI (sintaxe + comportamento), priorizando humanos, amigável para scripts.

Faça Isso Primeiro

Esclareça (rápido)

Pergunte, depois siga com suposições padrão caso o usuário não tenha certeza:

  • Nome do comando + propósito em uma frase.
  • Usuário principal: humanos, scripts, ou ambos.
  • Fontes de entrada: args vs stdin; arquivos vs URLs; segredos (nunca via flags).
  • Contrato de saída: texto humano, --json, --plain, códigos de saída.
  • Interatividade: prompts permitidos? precisa de --no-input? confirmações para operações destrutivas?
  • Modelo de configuração: flags/env/arquivo de configuração; precedência; XDG vs local ao repositório.
  • Restrições de plataforma/runtime: macOS/Linux/Windows; binário único vs runtime.

Entregáveis (o que gerar)

Ao projetar uma CLI, produza uma especificação compacta que o usuário possa implementar:

  • Árvore de comandos + sinopse USAGE.
  • Tabela de argumentos/flags (tipos, padrões, obrigatório/opcional, exemplos).
  • Semântica de subcomandos (o que cada um faz; idempotência; mudanças de estado).
  • Regras de saída: stdout vs stderr; detecção de TTY; --json/--plain; --quiet/--verbose.
  • Mapa de erros + códigos de saída (principais modos de falha).
  • Regras de segurança: --dry-run, confirmações, --force, --no-input.
  • Regras de configuração/env + precedência (flags > env > config do projeto > config do usuário > sistema).
  • História de conclusão de shell (se relevante): instalação/descoberta; comando de geração ou scripts empacotados.
  • 5–10 exemplos de invocação (fluxos comuns; inclua exemplos com pipe/stdin).

Convenções Padrão (a menos que o usuário indique o contrário)

  • -h/--help sempre mostra ajuda e ignora outros argumentos.
  • --version imprime versão no stdout.
  • Dados primários no stdout; diagnósticos/erros no stderr.
  • Adicione --json para saída de máquina; considere --plain para texto estável baseado em linhas.
  • Prompts apenas quando stdin é um TTY; --no-input desabilita prompts.
  • Operações destrutivas: confirmação interativa + não interativo requer --force ou --confirm=... explícito.
  • Respeite NO_COLOR, TERM=dumb; forneça --no-color.
  • Trate Ctrl-C: saia rápido; limpeza limitada; seja crash-only quando possível.

Modelos (copie na sua resposta)

Esqueleto de especificação CLI

Preencha estas seções, remova o que for irrelevante:

  1. Nome: meucomando
  2. Frase de efeito: ...
  3. USAGE:
    • meucomando [flags globais] <subcomando> [args]
  4. Subcomandos:
    • meucomando init ...
    • meucomando run ...
  5. Flags globais:
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose (defina exatamente)
    • --json / --plain (se aplicável)
  6. Contrato de E/S:
    • stdout:
    • stderr:
  7. Códigos de saída:
    • 0 sucesso
    • 1 falha genérica
    • 2 uso inválido (parsing/validação)
    • (adicione códigos específicos do comando apenas quando realmente úteis)
  8. Env/config:
    • variáveis de ambiente:
    • caminho do arquivo de configuração + precedência:
  9. Exemplos:
    • …

Notas

  • Prefira recomendar uma biblioteca de parsing (específica da linguagem) apenas quando solicitado; caso contrário, mantenha esta skill agnóstica à linguagem.
  • Se a solicitação for "parâmetros de design", não desvie para implementação.

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.

Habilidades Relacionadas