CommunityProgramación y desarrollogithub.com

steipete/create-cli

Diseño de CLI (UX/especificaciones): argumentos, flags, ayuda, salida, errores, configuración, simulación.

¿Qué es create-cli?

Esta habilidad está diseñada para ayudar a desarrolladores y agentes de IA a diseñar interfaces de línea de comandos (CLI) con un enfoque en la experiencia humana y la compatibilidad con scripts. Proporciona un proceso estructurado para aclarar los requisitos del usuario, especificar la sintaxis y el comportamiento de la CLI, y producir un documento de diseño compacto y listo para implementar. La habilidad se basa en las directrices estándar de la industria (clig.dev) y recomienda convenciones modernas como salida JSON, modo de simulación (dry-run), detección de terminal (TTY) y cumplimiento de `NO_COLOR`. Es ideal para diseñar herramientas CLI nuevas o refinar las existentes, independientemente del lenguaje de programación, ya que se centra en el diseño conceptual y la especificación funcional antes de la implementación. La habilidad guía al usuario a través de la definición del nombre del comando, los argumentos (args), las banderas (flags), los subcomandos, las reglas de entrada/salida, los códigos de error, la configuración y los ejemplos de uso, asegurando que la interfaz resultante sea coherente, predecible y fácil de usar tanto para humanos como para scripts automatizados.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Crear CLI

Diseñar la superficie de la CLI (sintaxis + comportamiento), centrada en humanos y amigable para scripts.

Haz esto primero

Aclarar (rápido)

Pregunta, luego procede con valores predeterminados basados en la mejor suposición si el usuario no está seguro:

  • Nombre del comando + propósito en una oración.
  • Usuario principal: humanos, scripts o ambos.
  • Fuentes de entrada: args vs stdin; archivos vs URLs; secretos (nunca a través de flags).
  • Contrato de salida: texto humano, --json, --plain, códigos de salida.
  • Interactividad: ¿se permiten avisos? ¿necesita --no-input? ¿confirmaciones para operaciones destructivas?
  • Modelo de configuración: flags/env/archivo de configuración; precedencia; XDG vs local al repositorio.
  • Restricciones de plataforma/ejecución: macOS/Linux/Windows; binario único vs runtime.

Entregables (qué producir)

Al diseñar una CLI, genera una especificación compacta que el usuario pueda implementar:

  • Árbol de comandos + resumen de USO.
  • Tabla de argumentos/banderas (tipos, valores predeterminados, obligatorio/opcional, ejemplos).
  • Semántica de subcomandos (qué hace cada uno; idempotencia; cambios de estado).
  • Reglas de salida: stdout vs stderr; detección de TTY; --json/--plain; --quiet/--verbose.
  • Mapa de errores + códigos de salida (principales modos de fallo).
  • Reglas de seguridad: --dry-run, confirmaciones, --force, --no-input.
  • Reglas de configuración/env + precedencia (flags > env > configuración del proyecto > configuración del usuario > sistema).
  • Historia de finalización de shell (si es relevante): instalación/descubribilidad; comando de generación o scripts empaquetados.
  • 5–10 ejemplos de invocación (flujos comunes; incluye ejemplos con pipes/stdin).

Convenciones predeterminadas (a menos que el usuario diga lo contrario)

  • -h/--help siempre muestra ayuda e ignora otros argumentos.
  • --version imprime la versión en stdout.
  • Datos principales a stdout; diagnósticos/errores a stderr.
  • Añade --json para salida para máquinas; considera --plain para texto estable basado en líneas.
  • Avisos solo cuando stdin es una TTY; --no-input desactiva los avisos.
  • Operaciones destructivas: confirmación interactiva + no interactivo requiere --force o --confirm=... explícito.
  • Respeta NO_COLOR, TERM=dumb; proporciona --no-color.
  • Maneja Ctrl-C: salida rápida; limpieza limitada; sé lo más "crash-only" posible.

Plantillas (copia en tu respuesta)

Esqueleto de especificación CLI

Completa estas secciones, omite lo irrelevante:

  1. Nombre: micomando
  2. Descripción en una línea: ...
  3. USO:
    • micomando [flags globales] <subcomando> [args]
  4. Subcomandos:
    • micomando init ...
    • micomando run ...
  5. Flags globales:
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose (define exactamente)
    • --json / --plain (si aplica)
  6. Contrato de E/S:
    • stdout:
    • stderr:
  7. Códigos de salida:
    • 0 éxito
    • 1 fallo genérico
    • 2 uso inválido (análisis/validación)
    • (añade códigos específicos del comando solo si realmente son útiles)
  8. Env/config:
    • variables de entorno:
    • ruta del archivo de configuración + precedencia:
  9. Ejemplos:
    • …

Notas

  • Prefiere recomendar una biblioteca de análisis (específica del lenguaje) solo cuando te lo pidan; de lo contrario, mantén esta habilidad independiente del lenguaje.
  • Si la solicitud es "diseñar parámetros", no te desvíes hacia la implementación.

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.

Skills relacionados