plan-devex-review

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

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-devex-review-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-devex-review
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/plan-devex-review
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-devex-review-sanjanb

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 silently kill adoption. This Skill audits a plan against proven developer experience standards 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. - Three review modes: DX EXPANSION for competitive advantage, DX POLISH for hardening every touchpoint, and DX TRIAGE for critical gaps only. - Persona-driven analysis: Builds developer personas, competitive benchmarks, magical moment specs, journey maps, and friction traces before scoring. - Outside voice check: Runs an independent cross-model review (Codex CLI or a Claude subagent) and surfaces cross-model disagreements for user decision. - Use Case: Before building a new public SDK, run a DX review on the plan to catch a 15-minute time-to-hello-world, undocumented breaking changes, and error messages that lack fixes, then walk through each finding interactively. ## Quick Start Ask the agent to run a DX review on my developer-facing product plan and score each dimension.

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 implementation?

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 before anything changes.

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

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

Does the DX review work for APIs, CLIs, and SDKs?

Yes, it is designed for developer-facing products including APIs, CLIs, SDKs, libraries, platforms, and documentation. It evaluates naming consistency, sensible defaults, idempotency, error structure, and time-to-hello-world against reference implementations like Stripe and GitHub CLI.

Can the DX review run without interactive prompts?

In headless sessions the review blocks when a question cannot be asked, while spawned sessions auto-choose recommended options. Interactive sessions use AskUserQuestion, with a prose fallback if the tool is unavailable.

What outputs does a DX plan 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 a JSONL task artifact for downstream plan aggregation.