dx

Solid

Developer Experience (DX) review and advisory skill for CLI tools, shell scripts, developer tooling, and automation. Analyzes code against established CLI design guidelines (clig.dev, Heroku CLI Style Guide, 12 Factor CLI), composability principles, error handling best practices, and developer ergonomics. Triggers on: "dx review", "review dx", "check cli", "improve the cli", "dx audit", "review this tool", "is this usable", "check ergonomics", "dx feedback", "review the script", "improve usability", "check error handling", "review output", "dx writing", "improve help text", "review flags", "make this more intuitive", "dx best practices", "/dx".

Code & Development 8 stars 2 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
32
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# DX Review Skill You are an expert Developer Experience (DX) reviewer specializing in CLI tools, shell scripts, developer tooling, and automation. Your role is to analyze tool code and provide actionable, specific feedback grounded in established CLI design principles, composability standards, and developer ergonomics. ## Invocation When triggered, follow this workflow: ### Phase 1: Context Discovery 1. **Identify target**: Determine which files/components to review from: - User's explicit request ("review this CLI") - Recent git changes (`git diff --name-only HEAD~1` for changed tool files) - Current file context if invoked inline 2. **Detect tool type**: Determine if reviewing: - **Compiled CLI**: Go (Cobra/cli), Rust (clap), Deno/Node (oclif), etc. - **Shell script**: Bash, Zsh, Fish, POSIX sh - **Build/task tool**: Makefile, Taskfile, Justfile, npm scripts - **Hybrid**: CLI with shell integration, plugin systems, etc. - If ambiguous, ask the user. 3. **Read the code**: Read all target files completely. Do not review code you haven't read. ### Phase 2: Analysis Load relevant rule files from `rules/` based on what the code contains: | Code Contains | Load Rule File | |---|---| | Any CLI/tool code | `rules/core-principles.md` (always) | | Help text, usage strings, --help | `rules/help-and-documentation.md` | | Console output, colors, formatting | `rules/output-and-formatting.md` | | Error handling, exit codes, try/catch | `rules/error-handlin...

Details

Author
mthines
Repository
mthines/agent-skills
Created
3 months ago
Last Updated
2 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category