Eng Agent Dx CLI Scale
A scoring scale for evaluating how well a CLI is designed for AI agents, based on the "Rewrite Your CLI for AI Agents" principles. Use when reviewing, designing, or comparing a CLI for agent use, or scoring its agent readiness.
Install
npx skills add jpoehnelt/skills --skill eng-agent-dx-cli-scalegit clone --depth 1 https://github.com/jpoehnelt/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/eng-agent-dx-cli-scale ~/.claude/skills/eng-agent-dx-cli-scalePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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](https://justin.poehnelt.com/posts/rewrite-your-cli-for-ai-agents/) --- ## Scoring Axes ### 1. 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. | ### 2. Raw Payload Input Can an agent send the full API payload without translation through bespoke flags? | Score | Criteria |
Details
- Skill name
eng-agent-dx-cli-scale- Repository
- jpoehnelt/skills
- Path
eng-agent-dx-cli-scale/SKILL.md- License
- MIT
- Repo updated
- 12 November 2026
FAQ
What does the Eng Agent Dx CLI Scale skill do?
A scoring scale for evaluating how well a CLI is designed for AI agents, based on the "Rewrite Your CLI for AI Agents" principles. Use when reviewing, designing, or comparing a CLI for agent use, or scoring its agent readiness.
How do I install the Eng Agent Dx CLI Scale skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add jpoehnelt/skills --skill eng-agent-dx-cli-scale. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Eng Agent Dx CLI Scale popular?
It lives in jpoehnelt/skills, which has 23 GitHub stars and 1 forks.
Related skills
Agents Correct
23jpoehnelt/skills
Find the mistakes agents keep repeating in a repo and make each one impossible, trying architecture first, then types, lint, tests, and docs last. Use when the operator keeps correcting the same mistake, or for /agents-correct.
Agents Create Verification Skill
23jpoehnelt/skills
Generate a project-local verify skill that drives the app like a user through a browser with Playwright, a CLI, or HTTP. Use for /agents-create-verification-skill, "make a verify skill for this repo", or when a project has no scripted way to prove UI, CLI, or service behavior.
Agents Reflect
23jpoehnelt/skills
After a work session, review what went wrong and right and turn each lesson into a concrete edit to an existing skill or AGENTS.md line. Use when the user says "reflect" or /agents-reflect.
Jeffdean Mind
9closedsi-engineering/JeffDean-Mind
Jeff Dean의 엔지니어링 사고방식으로 설계·코딩·리뷰를 수행한다. 시스템 설계, 아키텍처 결정, 성능 최적화, 분산 시스템, 확장성(스케일링), 지연시간(latency) 분석, 인프라 설계, 기술 선택, 코드 리뷰, 병목 분석, AI/ML 시스템 설계, 스타트업 기술 전략 관련 작업 시 사용한다. Triggers: "설계해줘", "아키텍처", "성능", "최적화", "확장", "스케일", "병목", "지연시간", "latency", "분산", "distributed", "design review", "백오브엔벨로프", "back-of-envelope", "제프 딘", "jeff dean", "capacity planning", "SLO", "p99".
Effect Boundary Validation
23jpoehnelt/skills
Decode untrusted data once at ingress with Effect Schema (v4) and pass typed values downstream. Use for HTTP bodies, params and query strings, webhooks, RPC and message payloads, MCP tool arguments, env and config, JSON.parse, stored JSON or rows, third-party API responses, unsafe casts, or porting Zod/Valibot schemas.
Nix Darwin
23jpoehnelt/skills
Manage macOS system defaults, Homebrew casks, Lix or Nix daemon settings, and Home Manager packages and dotfiles with a nix-darwin flake. Use when adding packages or casks, changing macOS defaults or launchd agents, debugging flake evaluation or brew bundle failures, or activating changes from an agent shell.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.