devex-review

Audits developer experience by testing onboarding flows and measuring time-to-hello-world.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documentation and onboarding flows often look fine on paper but fail in practice. This Skill actually tests the developer experience hands-on instead of guessing, producing an evidence-backed DX scorecard. ## Core Features & Use Cases - Live DX Testing: Navigates docs, runs the getting-started flow, and times time-to-hello-world (TTHW) using a browser tool. - Evidence Capture: Screenshots error messages and evaluates CLI help text to document real friction points. - Plan-vs-Reality Comparison: Compares measured results against /plan-devex-review scores (the boomerang: plan said 3 minutes, reality says 8). - Use Case: After shipping a new CLI or developer-facing feature, run a DX audit to verify a new user can actually get started, and get a scored report showing where they get stuck. ## Quick Start Ask the agent to run a live DX audit of the project's onboarding flow and produce a scorecard with TTHW measurements.

Frequently Asked Questions about devex-review

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

FAQPage Schema
How do I audit developer experience for my project?

Run a live DX audit that navigates your docs, attempts the getting-started flow, and times how long onboarding takes. The result is a scorecard with screenshots and evidence rather than subjective impressions.

How to measure time to hello world for onboarding?

Time-to-hello-world (TTHW) is measured by actually executing the getting-started flow from a fresh state and recording elapsed time. This skill automates that measurement and compares it against any previously planned estimate.

What is the difference between plan-devex-review and devex-review?

plan-devex-review produces predicted DX scores before shipping, while devex-review tests the real experience after shipping. Comparing the two reveals the gap between planned and actual onboarding time.

When should I run a developer experience audit?

Run it after shipping any developer-facing feature such as a CLI, SDK, or new documentation. It is also useful before launches to catch onboarding friction that internal testing missed.

Does the DX audit work in headless or CI environments?

The skill detects session kind (interactive, spawned, or headless) via its preamble and adapts behavior accordingly. In headless runs it blocks on interactive questions rather than prompting a nonexistent user.