forge-cli-design
CommunityDesign CLIs that scripts can trust.
Software Engineering#json output#argument parsing#cli design#exit codes#unix philosophy#stdin stdout stderr
Authorf4rkh4d
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It prevents AI-written CLIs from breaking shell pipelines by mixing logs and data, returning the wrong exit codes, and making output hard to parse or automate.
Core Features & Use Cases
- Pipe-friendly output discipline: keeps machine data on stdout and chatter on stderr, and enforces
--json(with streaming-friendly JSONL). - Safety and correctness guardrails: uses distinct, documented exit codes, supports
--dry-run, and requires interactive confirmation for destructive actions unless--yesis provided. - Predictable CLI structure: enforces Unix-style composition with
noun verbsubcommands, consistent--helpat every level, and stdin handling via the-convention.
Quick Start
Use this skill to design a new command-line tool by asking the agent: "Redesign my CLI so it has clear exit codes, supports --json with JSONL, routes chatter to stderr, enforces noun verb subcommands, and adds --dry-run and interactive confirmation for destructive commands."
Dependency Matrix
Required Modules
None requiredComponents
assets
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: forge-cli-design Download link: https://github.com/f4rkh4d/forge-skill/archive/main.zip#forge-cli-design Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.