skills.rest
TumeloRamaphosa
TumeloRamaphosaCOMMUNITY
Explore all skills by this author →
GitHub

devex-review

Execute documentation walkthroughs and score developer experience with evidence.

Updated May 7, 2026
Search Tags:#documentation#onboarding#developer experience#evidence capture#time-to-first-success#dx audit
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill devex-review-tumeloramaphosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: devex-review
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/gstack/devex-review
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill devex-review-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill measures developer experience by running a realistic onboarding and documentation walkthrough, then turns what it finds into an evidence-backed DX scorecard. It helps teams catch “it works on my machine” onboarding issues, vague setup steps, broken links, and CLI/docs mismatches before they cost time.

Core Features & Use Cases

  • Live DX audit with real navigation: Uses the browse tool to test docs and the getting started flow end-to-end, rather than relying on guesses.
  • Evidence gathering and scoring: Times key steps (including the TTHW moment), screenshots error states, and compiles the results into a DX scorecard with proof.
  • Plan-vs-reality comparison: Compares actual review outcomes against any existing plan-devex-review scores when available, surfacing where expectations diverged.
  • Best-fit triggers for DX testing: Runs when you ask to test DX, run a developer experience test, try onboarding, or validate a developer-facing change.

Quick Start

Ask the Skill to test the DX for your project by running the live developer experience audit.

Frequently Asked Questions about devex-review

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

FAQPage Schema
How do I test developer experience and onboarding documentation?▼

Testing developer experience involves executing a live onboarding walkthrough that navigates your documentation end-to-end, capturing timings and failure evidence to measure actual user effort and time-to-first-success.

What is time-to-first-success and how is it measured during a DX audit?▼

Time-to-first-success is the timing of when a new contributor successfully completes the setup flow, measured during a live DX audit by navigating documentation and capturing step durations as evidence.

How do I validate getting-started instructions and catch documentation mismatches?▼

Validating getting-started instructions requires executing the setup flow live and capturing failure evidence like broken links or CLI mismatches to catch onboarding issues before they cost time.

Can I compare actual onboarding test results against planned DX review scores?▼

Yes, you can compare actual review outcomes against existing plan-devex-review results, surfacing where expectations diverged from the real walkthrough to identify gaps in your developer experience.

What does a developer experience scorecard include when testing onboarding flows?▼

A DX scorecard includes timed key steps, screenshots of error states, and compiled evidence from the live walkthrough, providing proof-backed scoring of your documentation and setup flow quality.

What problems does a live developer experience audit solve for new contributors?▼

A live DX audit solves onboarding problems like vague setup steps, broken links, CLI mismatches, and machine-specific issues by testing the flow end-to-end rather than relying on guesses.

Related Skills

Explore More Software Engineering Skills→
26mitch2626mitch26

devex-review

Audit developer experience by navigating documentation and measuring onboarding time.

Community
Advanced
westnwestn
1

devex-review

Audit developer experience by timing onboarding flows and generating a DX scorecard.

Community
Advanced
yashs33244yashs33244
1

devex-review

Run live onboarding tests and produce DX scorecards with evidence.

Community
Advanced
pjastampjastam
3

hyalo-tidy

Detect structural issues and fix broken links in a Hyalo knowledgebase.

Community
Advanced