Designing CLIs That AI Agents Can Actually Use

As AI agents become more capable of running shell commands, traditional CLI design optimized for human terminals becomes a bottleneck. The SKILL.md pattern demonstrates that with minimal changes—structured output, exit codes, and workflow documentation—existing CLIs can become powerful agent tools without sacrificing human usability. This shift is critical for developers building in an agent-first ecosystem, where CLIs serve dual purposes and require a new architectural mindset.