# agent-dx-cli-scale

> Claude/Codex skill by [@google-labs-code](https://omgskills.com/library/google-labs-code/index.md) · 27k stars · Updated 2026-07-27

A scoring scale for evaluating how well a CLI is designed for AI agents, based on the "Rewrite Your CLI for AI Agents" principles.

## Install

```sh
git clone https://github.com/google-labs-code/design.md /tmp/design.md && ln -s /tmp/design.md/.agents/skills/agent-dx-cli-scale ~/.claude/skills/agent-dx-cli-scale
```

## From README

Agent DX CLI Scale Use this skill to evaluate any CLI against the principles of agent-first design. Score each axis from 0–3, then sum for a total between 0–21. Human DX optimizes for discoverability and forgiveness. Agent DX optimizes for predictability and defense-in-depth. — You Need to Rewrite Your CLI for AI Agents --- Scoring Axes Machine-Readable Output Can an agent parse the CLI's output without heuristics? | Score | Criteria | | ----- | ----------------------------------------------------------------------------------------------------- | | 0 | Human-only output (tables, color codes, prose). No structured format available. | | 1 | --output json or equivalent exists but is incomplete or inconsistent across commands. | | 2 | Consistent JSON output across all commands. Errors also return structured JSON. | | 3 | NDJSON streaming for paginated results. Structured output is the default in non-TTY (piped) contexts.

## Links

- HTML page: https://omgskills.com/skills/google-labs-code/design.md/agent-dx-cli-scale/
- GitHub: https://github.com/google-labs-code/design.md
- Author: [@google-labs-code](https://omgskills.com/library/google-labs-code/index.md)

## More from this repo

- [ink](https://omgskills.com/skills/google-labs-code/design.md/ink/index.md) — Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs.
   - [@google-labs-code](https://omgskills.com/library/google-labs-code/index.md) · 27k stars
- [typed-service-contracts](https://omgskills.com/skills/google-labs-code/design.md/typed-service-contracts/index.md) — Architecture standard for building robust, type-safe TypeScript services using the "Spec and Handler" pattern.
   - [@google-labs-code](https://omgskills.com/library/google-labs-code/index.md) · 27k stars

## More skills by this author

- [enhance-prompt](https://omgskills.com/skills/google-labs-code/stitch-skills/enhance-prompt/index.md) — Transforms vague UI ideas into polished, Stitch-optimized prompts.
   - [@google-labs-code](https://omgskills.com/library/google-labs-code/index.md) · 7.9k stars