agent-native-design

# agent-native-design ## Purpose This skill helps analyze, design, and refactor command-line tools so they can reliably serve **humans**, **AI agents**, and **orchestration systems** at the same time. It is not a skill for merely *using* a CLI. It is a skill for designing and reviewing a CLI as an **agent-native interface**. The skill focuses on four goals: 1. Make CLI behavior predictable for AI agents. 2. Make CLI output readable and recoverable for humans. 3. Make CLI execution manageable for systems and orchestrators. 4. Define a complete interaction loop from authentication to error routing. --- ## When to use this skill Use this skill when the user wants to: * evaluate whether an existing CLI is agent-friendly * redesign a CLI to better support AI agents * convert an API or SDK into an agent-native CLI * review help output, schema design, exit codes, or JSON contracts * design dry-run, auth delegation, or safety boundaries * generate CLI skills, docs, or interface conventions from schema * refactor a human-oriented CLI into a machine-friendly one * define how a CLI should interact with an agent runtime Typical prompts include: * "Review this CLI and tell me whether it is agent-native." * "Design a CLI for this API that an AI agent can use reliably." * "Refactor this tool so stdout is machine-readable and safer for agents." * "Help me define schema introspection, dry-run, and exit code semantics." ## When not to use this skill Do not use this skill when the ...