Design System
affaan-m/ECC
Generate a design system from an existing codebase or audit one for visual consistency: extract tokens (colors, typography, spacing, shadows) into design-tokens.json and CSS custom properties with…
Designing CLIs that AI agents will invoke — non-interactive flags, layered --help with examples, stdin/pipeline composition, actionable errors, idempotency, dry-run, destructive-action safety, and…
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pproenca/dot-skills cli-for-agents --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/cli-for-agents .claude/skills/cli-for-agents && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .claude/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agentsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pproenca/dot-skills cli-for-agents --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.experimental/cli-for-agents .agents/skills/cli-for-agents && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .agents/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pproenca/dot-skills cli-for-agents --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.experimental/cli-for-agents .cursor/skills/cli-for-agents && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .cursor/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pproenca/dot-skills.git --path skills/.experimental/cli-for-agents--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pproenca/dot-skills cli-for-agents --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.experimental/cli-for-agents .gemini/skills/cli-for-agents && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .gemini/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pproenca/dot-skills cli-for-agentsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.experimental/cli-for-agents .github/skills/cli-for-agents && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .github/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill cli-for-agents -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pproenca/dot-skills cli-for-agents --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.experimental/cli-for-agents .opencode/skills/cli-for-agents && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cli-for-agents" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/cli-for-agents into .opencode/skills/cli-for-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-for-agents", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
cli-for-agentsDesigning CLIs that AI agents will invoke — non-interactive flags, layered --help with examples, stdin/pipeline composition, actionable errors, idempotency, dry-run, destructive-action safety, and…
CLI For Agents is an agent skill from pproenca/dot-skills. Designing CLIs that AI agents will invoke — non-interactive flags, layered --help with examples, stdin/pipeline composition, actionable errors, idempotency, dry-run, destructive-action safety, and predictable command structure. Use when designing, building, or reviewing a command-line tool that AI agents or automation will invoke. Trigger even if the user doesn't explicitly say "agent-friendly" — apply whenever they are writing --help text, adding a new subcommand, designing error messages, or reviewing a CLI's UX.
Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 52 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).
The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
CLI For Agents loads about 2.6k tokens when it runs, and up to ~29k if it reads all its reference files. Until then it costs about 134 tokens; SKILL.md has 905 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 905 words, ~2,558 tokens.
.claude/skills/cli-for-agents/SKILL.md (or your agent's skills folder). This skill also uses 49 other files; get the full folder from GitHub.Prescriptive design and review standards for Command-Line Interface Design targeting AI agents and scripts, not just humans typing at a prompt. Human-oriented CLIs often block agents: interactive prompts, huge upfront docs, help text without copy-pasteable examples, error messages without fixes, no dry-run mode. This skill prioritizes rules by blast radius — from "the agent cannot use this CLI at all" (CRITICAL) to "the agent has to read help one extra time" (MEDIUM).
Use this skill both when building a new CLI and when reviewing an existing one for agent-friendliness.
This skill contains 45 rules across 8 categories.
Reference these guidelines when:
--help text for any subcommand| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Non-interactive Operation | CRITICAL | interact- |
| 2 | Help Text Design | HIGH | help- |
| 3 | Error Messages | HIGH | err- |
| 4 | Destructive Action Safety | HIGH | safe- |
| 5 | Input Handling | HIGH | input- |
| 6 | Output Format | MEDIUM-HIGH | output- |
| 7 | Idempotency & Retries | MEDIUM-HIGH | idem- |
| 8 | Command Structure | MEDIUM | struct- |
Note: help-examples-in-help is rated CRITICAL within the HIGH help- category because its specific failure — help text without examples — makes every other help rule moot. The category label reflects the average, not the worst case.
interact-flags-first — Express every input as a flag first; prompts are TTY-only fallbackinteract-detect-tty — Check isatty() before promptinginteract-no-arrow-menus — Replace arrow-key menus with flag-selected choicesinteract-no-input-flag — Support --no-input to force non-interactive modeinteract-no-timed-prompts — Never use timed prompts or press-any-key screensinteract-no-hang-on-stdin — Don't block on stdin when a TTY is attachedhelp-examples-in-help — Include copy-pasteable examples in every --helphelp-per-subcommand — Every subcommand owns its own --helphelp-no-flag-required — Show help when invoked with zero argumentshelp-layered-discovery — Top-level help is a navigational indexhelp-flag-summary — List both short and long forms for every flaghelp-suggest-next-steps — Suggest what to run next in help and success outputerr-exit-fast-on-missing-required — Exit fast on missing required flagserr-actionable-fix — Include a concrete fix in every error messageerr-stderr-not-stdout — Send errors to stderr, not stdouterr-non-zero-exit-codes — Use distinct non-zero exit codes for distinct failureserr-include-example-invocation — Include a correct example invocation in errorserr-no-stack-traces-by-default — Reserve stack traces for --debug modesafe-dry-run-flag — Provide --dry-run for every destructive commandsafe-force-bypass-flag — Provide --yes / --force to skip confirmationssafe-confirm-by-typing-name — Require typing the resource name for irreversible actionssafe-no-prompts-with-no-input — Never prompt when --no-input is setsafe-idempotent-cleanup — Exit successfully when delete targets are already gonesafe-crash-only-recovery — Design multi-step commands for crash-only recoveryinput-accept-stdin-dash — Accept - as filename for stdin and stdoutinput-flags-over-positional — Prefer named flags over positional argumentsinput-stdin-for-secrets — Accept secrets through stdin or file, never as flag valuesinput-env-var-fallback — Accept common flags through environment variablesinput-no-prompt-fallback — Never fall back to a prompt when a flag is missingoutput-json-flag — Provide --json for stable machine-readable outputoutput-ndjson-streaming — Stream large result sets as NDJSONoutput-bounded-by-default — Bound default output size with --limit and --alloutput-machine-ids-on-success — Return chainable values on success, not just "Done"output-respect-no-color — Disable ANSI color when NO_COLOR or non-TTYoutput-no-decorative-only — Avoid relying on decorative output to convey stateoutput-one-record-per-line — One record per line for grep-able human outputidem-retry-safe — Make running the same command twice safeidem-create-or-skip — Make create commands skip when target already existsidem-stable-output-on-skip — Return the same output shape whether acting or skippingidem-state-reconciliation — Prefer "ensure state" semantics over delta applicationidem-stable-identifiers — Accept user-provided names instead of auto-generating IDsstruct-resource-verb — Use a consistent resource-verb command shapestruct-flag-order-independent — Parse flags in any position relative to subcommandsstruct-no-hidden-subcommand-catchall — Avoid catch-all handlers for unknown subcommandsstruct-standard-flag-names — Use standard flag names (--help, --version, --verbose, --quiet)Start at CRITICAL and walk down. The first two categories (interact- and help-) are non-negotiable — if any rule in these is violated, the CLI is unusable by agents regardless of how good the rest is. After those, work through err-, safe-, and input- — these are where most real-world friction lives. output-, idem-, and struct- are polish that compounds across many invocations.
Run through this checklist in priority order:
--no-input or under </dev/null and see which hangmycli --help list subcommands only, or dump everything?--help — every subcommand's help should end with a runnable Examples section- mean stdin?--dry-run (or equivalent)--yes/--forceservice list, deploy list, config list all exist and work the same way?deploy return a deploy_id the agent can use next?Read individual reference files for detailed explanations and code examples:
| File | Description |
|---|---|
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
| metadata.json | Version and reference information |
© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 49 other files (references, assets) in skills/.experimental/cli-for-agents of pproenca/dot-skills.
Open the folder on GitHubat commit cf93c57
CLI For Agents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| CLI For Agents this skillpproenca/dot-skills | 214 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Design Systemaffaan-m/ECC | 274k | — | ~698 | Automated safety check: Pass | MIT | |
| Design Guidepaperclipai/paperclip | 98k | 1 repos | ~3.1k | Automated safety check: Pass | MIT | |
| Design Audit Against Rams' Principlesthedotmack/claude-mem | 97k | — | ~4.6k | Automated safety check: Pass | Apache-2.0 | |
| Figma Design to Codewarpdotdev/warp | 65k | 4 repos | ~2.9k | Automated safety check: Pass | AGPL-3.0 | |
| Design Consultationgarrytan/gstack | 136k | — | ~15k | Automated safety check: Notes | MIT |
affaan-m/ECC
Generate a design system from an existing codebase or audit one for visual consistency: extract tokens (colors, typography, spacing, shadows) into design-tokens.json and CSS custom properties with…
paperclipai/paperclip
Paperclip UI design system guide for building consistent, reusable frontend components.
thedotmack/claude-mem
Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.
warpdotdev/warp
Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.
garrytan/gstack
Learns about your product, studies the landscape and writes a DESIGN.md with a full design system covering type, color, layout, spacing and motion.
XiaomiMiMo/MiMo-Code
Entry point to a bundle of product design workflows covering context, research, audits, ideation, URL or image to code, design QA and sharing a prototype.
pproenca/dot-skills
Audio forensics and voice recovery guidelines for CSI-level audio analysis.
pproenca/dot-skills
Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.
pproenca/dot-skills
Create well-structured RFCs and technical proposals for software projects.
pproenca/dot-skills
Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
pproenca/dot-skills
Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…
pproenca/dot-skills
Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…
Designing CLIs that AI agents will invoke — non-interactive flags, layered --help with examples, stdin/pipeline composition, actionable errors, idempotency, dry-run, destructive-action safety, and…. CLI For Agents is an agent skill from pproenca/dot-skills. Designing CLIs that AI agents will invoke — non-interactive flags, layered --help with examples, stdin/pipeline composition, actionable errors, idempotency, dry-run, destructive-action safety, and predictable command structure.
CLI For Agents fits situations like: reviewing a command-line tool that AI agents; automation will invoke; even if the user doesnt explicitly say agent-friendly — apply whenever they are writing --help text; adding a new subcommand.
Run `npx skills add pproenca/dot-skills --skill cli-for-agents -a claude-code`. Or copy the skill folder (skills/.experimental/cli-for-agents in pproenca/dot-skills) into .claude/skills/cli-for-agents in your project. Claude Code loads it when a task matches its description.
Run `npx skills add pproenca/dot-skills --skill cli-for-agents -a codex`. Or copy the skill folder (skills/.experimental/cli-for-agents in pproenca/dot-skills) into .agents/skills/cli-for-agents in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill cli-for-agents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-for-agents, .gemini/skills/cli-for-agents, .github/skills/cli-for-agents and .opencode/skills/cli-for-agents in your project.
SKILL.md names no scripts, command-line tools or credentials: CLI For Agents is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
CLI For Agents is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 27k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with CLI For Agents: Design System (affaan-m/ECC, 274k stars), Design Guide (paperclipai/paperclip, 98k stars), Design Audit Against Rams' Principles (thedotmack/claude-mem, 97k stars) and Figma Design to Code (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.
Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.