Development

cli-builder

Guides agents in building and refactoring non-interactive CLI tools with stable help and JSON contracts, truthful exit codes, idempotent mutations, authentication safety, and dry-run previews.

★ 88 GitHub Stars
92 Quality score
10 Files

About this Skill

Build or refactor agent-facing CLI tools with non-interactive commands, stable --help and --json contracts, idempotent operations, and --dry-run previews. Use for CLI design, agent-friction refactors, output/exit-code debugging, or automation safety. Do not use for GUI/TUI design, conversational tools, MCP server design, or general API architecture; use api-design-and-evolution for the latter.

Use cases

  • Designing agent-facing CLIs
  • Refactoring parser-hostile command output
  • Adding stable --json and --help contracts
  • Debugging output and exit codes
  • Making automation safe with dry-runs and idempotency

Features

  • Workflow for discovering real CLI contracts
  • Guidance for stable help, JSON, stderr, and exit-code behavior
  • Patterns for dry-run and explicit destructive-operation authorization
  • Bash scaffold for local CLI wrappers
  • References for Python API clients and advanced CLI patterns

Requirements

  • Bash
  • Python 3.8+
  • jq
  • Standard Unix CLI environment

Supported Agents

Not specified

Skill files

Related Skills

electronics

Guides agents in designing, reviewing, prototyping, measuring, and troubleshooting electronic circuits using component evidence, worst-case analysis, interface contracts, and stag…

magnus919/agent-skills ★ 88
electronics circuit design analog digital

supabase

Guides agents in developing, testing, deploying, and administering managed or self-hosted Supabase projects, including migrations, RLS, client types, services, backups, upgrades, …

magnus919/agent-skills ★ 88
supabase postgres database migrations row-level security

langgraph

Helps design, implement, evaluate, debug, and deploy stateful multi-agent workflows with LangGraph, including supervisor, swarm, hierarchical, persistence, subgraph, and human-in-…

magnus919/agent-skills ★ 88
langgraph multi-agent agent orchestration stateful workflows

digital-twin

Guides agents in designing, evaluating, governing, operating, evolving, and retiring digital twins and federated twin universes with synchronization, simulation, authority, and li…

magnus919/agent-skills ★ 88
digital twins digital thread simulation predictive maintenance

migration-engineering

Guides agents through safe cross-system migrations involving data, schemas, interfaces, infrastructure, and service ownership, using compatibility windows, dual-running, reconcili…

magnus919/agent-skills ★ 88
migration data migration schema migration api migration

software-architecture

Guides system-level architecture decisions from business drivers through boundaries, tradeoffs, runtime behavior, evolution, evidence, and architecture reviews.

magnus919/agent-skills ★ 88
software architecture architecture design distributed systems modularity

hugo-theme

Helps agents build, customize, and debug Hugo themes, including templates, asset pipelines, shortcodes, render hooks, content organization, performance, SEO, accessibility, and CI…

magnus919/agent-skills ★ 88
hugo themes templates asset pipeline

multi-tenant-saas-architecture

Guides agents in designing and reviewing multi-tenant SaaS architectures, covering tenant semantics, system planes, isolation choices, onboarding, entitlements, billing handoffs, …

magnus919/agent-skills ★ 88
multi-tenant saas control-plane application-plane