plan-devex-review

Reviews developer experience plans across eight scored passes with interactive decision prompts.

Updated Aug 9, 2026
One-click install
npx skills add https://github.com/raghavbadhwar/rstack --skill plan-devex-review-raghavbadhwar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-devex-review
Source: https://github.com/raghavbadhwar/rstack/tree/main/plan-devex-review
Command: npx skills add https://github.com/raghavbadhwar/rstack --skill plan-devex-review-raghavbadhwar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Plans for developer-facing products (APIs, CLIs, SDKs, libraries, docs) often ship with onboarding friction, weak error messages, and missing upgrade paths that only surface after adoption stalls. This Skill audits a plan against proven developer experience benchmarks before implementation begins. ## Core Features & Use Cases - Eight scored DX passes: Evaluates getting started, API/CLI/SDK design, error messages, documentation, upgrade paths, dev environment, community, and DX measurement, each rated 0-10 with a trend-aware scorecard. - Persona-driven investigation: Builds a developer persona, empathy narrative, competitive benchmark, magical moment spec, journey map, and first-time-user confusion report before scoring. - Three review modes: DX EXPANSION for competitive advantage, DX POLISH for hardening every touchpoint, and DX TRIAGE for critical gaps only. - Outside voice cross-check: Runs an independent Codex or Claude subagent review and surfaces cross-model disagreements for user decision. - Use Case: Before building a new CLI tool, run a DX review on the plan to discover that installation requires five manual steps, then decide interactively how to reach a one-command install with a sub-5-minute time-to-hello-world. ## Quick Start Ask the agent to run a developer experience review on your plan document, for example by saying "run a DX review on my API launch plan".

Frequently Asked Questions about plan-devex-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a developer experience plan before building an API or CLI?

Invoke the DX review on your plan document and it walks through eight scored passes covering getting started, API design, error messages, docs, upgrades, tooling, community, and measurement. Each finding is presented as an interactive decision with a recommendation.

What does the DX review evaluate in each pass?

Each pass rates one dimension 0-10: installation friction, API naming and defaults, error message quality against Elm/Rust/Stripe tiers, documentation findability, migration paths, editor and CI integration, ecosystem health, and TTHW instrumentation.

What is the difference between DX EXPANSION, POLISH, and TRIAGE modes?

EXPANSION targets competitive advantage by benchmarking against best-in-class developer products. POLISH hardens every touchpoint of an existing experience. TRIAGE identifies only critical gaps that block adoption.

Does the DX review work for Claude Code skills and MCP servers?

Yes, it includes a conditional checklist for Claude Code skill DX covering AskUserQuestion design, state storage, progressive consent, auto-upgrade, skill composition, and error recovery, run only when the product type matches.

Can the DX review run without interactive prompts?

In headless sessions an unavailable AskUserQuestion blocks the review, while spawned sessions auto-choose recommended options. The outside voice cross-check via Codex can be disabled with gstack-config set codex_reviews disabled.