plan-devex-review

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

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill plan-devex-review-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-devex-review
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/plan-devex-review
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill plan-devex-review-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Plans for developer-facing products (APIs, CLIs, SDKs, libraries, platforms) often ship with onboarding friction, weak error messages, and missing migration paths that only surface after adoption stalls. This Skill runs a structured, interactive developer experience audit of a plan before implementation, scoring each DX dimension and forcing explicit decisions on every gap. ## Core Features & Use Cases - Eight scored DX passes: Getting Started, API/CLI/SDK design, error messages, documentation, upgrade paths, dev environment, community, and DX measurement, each rated 0-10 against a hall-of-fame reference (Stripe, Vercel, Elm, Rust). - Three review modes: DX EXPANSION for competitive advantage, DX POLISH for full touchpoint coverage, and DX TRIAGE for critical gaps only. - Persona-grounded investigation: builds a developer persona, empathy narrative, competitive benchmark, magical moment spec, journey map, and confusion roleplay before scoring. - Outside voice cross-check: optionally runs an independent Codex or Claude subagent review and surfaces cross-model disagreements for user decision. - Use Case: Before building a new public SDK, run a DX review on the plan to discover that onboarding requires five setup steps, then decide interactively which friction points to fix and emit a scorecard plus implementation tasks. ## Quick Start Ask the assistant to run a DX review of your developer-facing product plan, for example by saying "run a devex 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 SDK?

Invoke the DX review on your plan document. It runs eight scored passes covering getting started, API design, errors, docs, upgrades, tooling, community, and measurement, asking you to decide on each finding before producing a scorecard.

What are the DX EXPANSION, POLISH, and TRIAGE modes?

EXPANSION benchmarks against competitors to find advantage, POLISH audits every developer touchpoint for completeness, and TRIAGE surfaces only critical gaps. You pick the mode at the start based on how deep the review should go.

Does the DX review work for non-API products like CLIs and libraries?

Yes. The review targets any developer-facing product including APIs, CLIs, SDKs, libraries, platforms, and documentation. It also has a conditional checklist for Claude Code skills and AI agent tools.

What is the outside voice step in the review?

After the eight passes, an independent second opinion runs via the Codex CLI or a Claude subagent. Disagreements with the main review are presented as cross-model tension points, and you decide each one explicitly.

What outputs does the DX review produce?

It produces a persona card, empathy narrative, competitive benchmark, magical moment spec, journey map, confusion report, a DX scorecard with per-dimension scores and trends, an implementation checklist, and JSONL task artifacts for autoplan aggregation.