skills.rest
tgmarinho
tgmarinhoCOMMUNITY
Explore all skills by this author →
Website𝕏@tgmarinhoGitHub

devex-review

Tests developer experience by navigating docs, timing onboarding, and scoring DX with evidence.

Updated May 15, 2026
Search Tags:#onboarding#developer experience#documentation review#scorecard#cli testing#dx audit#tthw
One-click install
npx skills add https://github.com/tgmarinho/canetaco --skill devex-review-tgmarinho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: devex-review
Source: https://github.com/tgmarinho/canetaco/tree/main/.claude/skills/devex-review
Command: npx skills add https://github.com/tgmarinho/canetaco --skill devex-review-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developer experience claims are rarely verified against reality. This Skill performs a live DX audit: it actually walks through your documentation, runs the getting-started flow, times time-to-hello-world (TTHW), screenshots error messages, and evaluates CLI help text, producing an evidence-backed DX scorecard instead of guesses. ## Core Features & Use Cases - Live Onboarding Test: Navigates docs and executes the getting-started flow like a real new developer, measuring actual TTHW. - Evidence-Based Scorecard: Captures screenshots of error messages and evaluates CLI help output, then produces a scored DX report. - Plan-vs-Reality Comparison: Compares results against prior /plan-devex-review scores (the boomerang: plan said 3 minutes, reality says 8). - Use Case: After shipping a new CLI or SDK, run a DX audit to discover that the install step fails on a fresh machine and the README quickstart references a renamed flag. ## Quick Start Ask the assistant to run a live DX audit of the project's onboarding flow and produce a scorecard with evidence.

Frequently Asked Questions about devex-review

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

FAQPage Schema
How do I test the developer experience of my CLI or SDK?▼

Run a live DX audit that walks the getting-started flow as a new user would: follow the docs, run the install commands, and time how long until the first working result. The audit produces a scorecard with screenshots and timings as evidence.

What is TTHW and how do I measure it?▼

TTHW (time to hello world) is the elapsed time from a developer landing on your docs to running their first successful command. Measure it by executing the onboarding steps fresh and recording the duration, including time lost to errors.

How does the DX audit compare planned vs actual onboarding time?▼

If a prior /plan-devex-review produced estimated scores, the live audit compares them against measured reality. For example, a plan claiming 3-minute onboarding is flagged when the real run takes 8 minutes.

When should I run a developer experience audit?▼

Run it after shipping any developer-facing feature such as a CLI, SDK, or new quickstart guide. It is also useful before launches to catch broken install steps, stale docs, and unhelpful error messages.

What evidence does a DX audit collect?▼

The audit captures screenshots of error messages, evaluates CLI help text quality, records timings for each onboarding step, and compiles everything into a structured DX scorecard.

Related Skills

Explore More Software Engineering Skills→
VIPER-MetricsVIPER-Metrics
1

document-feature

Generates Word/PDF/HTML documents from templates and JSON data feeds.

Official
Advanced
robritacca-dotcomrobritacca-dotcom
1

super-ship

Chains a full drift audit with the ship flow to fix stale docs and deploy structural changes.

Community
Advanced
wodehwodeh

devex-review

Navigate docs, onboarding, and CLI help to produce a DX scorecard with evidence.

Community
Advanced
23000311472300031147

devex-review

Diagnose developer experience via live audits of docs, onboarding, and CLI help.

Community
Advanced