Agent skill

create-cli

Design CLI tools with consistent UX patterns.

View SKILL.md on GitHub Repository
Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/michalvavra/agents/tree/main/archive/skills/create-cli

SKILL.md

Create CLI

Design CLI surface area: syntax, flags, output, error handling.

Conventions

  • Long options preferred (--from not -f)
  • stdout for data, stderr for progress/errors
  • Exit codes: 0=success, 1=runtime error, 2=usage error
  • Include --help, --json, --quiet
  • Validate early, fail fast

Output

  • Default: human-readable tables
  • --json: JSON output (implies quiet)
  • --quiet: suppress progress
  • Respect NO_COLOR env

Errors

<name>: <message>
Try '<name> --help'

Destructive Operations

  • Confirm when stdin is TTY
  • --force to skip confirmation
  • --dry-run to preview

Help Format

<name> - <one-line description>

USAGE
    <name> [OPTIONS] <ARGS>

OPTIONS
    --option <VALUE>    Description [default: X]
    --help              Show this help

EXAMPLES
    <name> arg1 arg2

See references/node-js.md - Node.js with parseArgs See references/python-uv.md - Python with uv

See clig.dev for comprehensive guidelines.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

michalvavra/agents

brave-search

Web search via the Brave Search API. Use to retrieve search results from Brave when web lookups are needed.

6 1
Explore
michalvavra/agents

write-docs

Write AI-scannable technical documentation.

6 1
Explore
michalvavra/agents

dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

6 1
Explore
michalvavra/agents

snowcli

CLI for Snowflake. Query data, manage warehouses, databases, schemas, tables, and stages. Use when working with Snowflake data platform.

6 1
Explore
michalvavra/agents

qmd-knowledge

Knowledge management with QMD (Quick Markdown Search). Search, retrieve, and organize your personal knowledge base, notes, docs, and meeting transcripts. Use when asking about past notes, documentation, meetings, or when needing to recall information from your indexed markdown files.

6 1
Explore
michalvavra/agents

compare-tech

Compare technologies using a weighted scoring matrix. Use when evaluating libraries, frameworks, SaaS, or infrastructure options.

6 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results