devex-review

Audit onboarding flows, documentation, CLI help, and error messages to produce a DX scorecard.

1|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/cattboy/lil_bro --skill devex-review-cattboy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devex-review
Source: https://github.com/cattboy/lil_bro/tree/main/.claude/skills/devex-review
Command: npx skills add https://github.com/cattboy/lil_bro --skill devex-review-cattboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines validating the developer experience by performing a live audit of onboarding flows, docs, CLI help, and error messages to surface actionable DX gaps.

Core Features & Use Cases

  • Live developer experience audit: navigate docs, test onboarding flows, time tasks, capture findings, and gather evidence.
  • DX scorecard: generates a structured report comparing results against plans or benchmarks and highlights gaps.
  • Evidence-driven recommendations: combines findings into concrete next steps for engineering, product, and docs teams.

Quick Start

Run a live DX audit from the current project to generate a DX 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 run a developer experience audit for my project?

Run a developer experience audit by walking onboarding flows, navigating documentation, testing CLI help, and capturing error messages. The audit collects timings and screenshots to produce a structured DX scorecard with evidence highlighting gaps.

What is a DX scorecard and how does it surface onboarding gaps?

A DX scorecard is a structured report comparing live audit results against baseline plans or benchmarks. It combines timings, screenshots, and findings into concrete next steps for engineering, product, and docs teams to address onboarding gaps.

Can I evaluate CLI help and error messages as part of a live DX review?

Yes, you can evaluate CLI help and error messages during a live DX review. The audit workflow captures these interactions to surface actionable developer experience gaps and includes them in the final scorecard evidence.

How do I measure documentation navigation and onboarding task timings?

Measure documentation navigation and onboarding timings using the browse-based audit workflow. It walks through onboarding sequences, records task durations, captures screenshots, and compares results against a baseline plan when present.

What is the best way to validate developer experience for local projects?

Validate developer experience for local projects by running a live audit that reviews onboarding flows, docs, CLI usage, and errors. This generates a repeatable scorecard with evidence to drive improvements across teams.

Do I need a baseline plan to generate a developer experience scorecard?

No, a baseline plan is not required, but when present, the scorecard compares live audit results against it. Without a baseline, it still captures timings and screenshots to produce evidence-driven recommendations.