devex-review

Audit developer experience and generate a scorecard with evidence.

3|Updated Oct 12, 2025
One-click install
npx skills add https://github.com/mostafasudo/warpy --skill devex-review-mostafasudo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devex-review
Source: https://github.com/mostafasudo/warpy/tree/main/.codex/skills/gstack/devex-review
Command: npx skills add https://github.com/mostafasudo/warpy --skill devex-review-mostafasudo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill conducts a live developer experience audit, testing the ease of navigating documentation, getting started workflows, and CLI help text, and produces a scorecard with evidence.

Core Features & Use Cases

  • Live DX Audit: Tests the developer experience by navigating documentation, getting started flows, timing tasks, and capturing screenshots of error messages.
  • DX Scorecard: Generates a report with a DX score and evidence.
  • Comparison: Compares the audit results against planned dev experience scores if available.
  • Proactive Usage: Suggest using the skill after shipping a developer-facing feature to ensure a positive onboarding experience.

Quick Start

Run the 'dx audit' command to initiate the 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 conduct a live developer experience audit for my software product?

A live developer experience audit tests documentation navigation, getting started workflows, and CLI help text, then generates a developer experience scorecard with evidence. Run the 'dx audit' command to initiate the automated testing and scoring process.

What is a DX scorecard and how does it help improve onboarding?

A DX scorecard is a report that quantifies the developer experience by providing a score alongside evidence of navigation issues or workflow friction. It helps teams verify and improve onboarding by highlighting specific areas in the documentation or CLI that need attention.

How do I verify the developer experience after shipping a new CLI feature?

To verify the developer experience after shipping a CLI feature, run a live audit to test the new CLI help text and getting started workflows. The audit times tasks and captures screenshots of error messages to ensure a positive onboarding experience.

How do I compare my actual developer experience score against planned targets?

You can compare actual developer experience scores against planned targets by running a live audit and generating a DX scorecard. The audit results provide the evidence needed to compare your current state directly against your planned dev experience scores.

Does the developer experience audit capture screenshots of CLI error messages?

Yes, the developer experience audit captures screenshots of error messages encountered during testing. It also times task completion and navigates documentation workflows to provide comprehensive evidence for the final DX scorecard.

Can I use a developer experience audit to test documentation navigation flows?

Yes, you can use a developer experience audit to test documentation navigation flows. The audit specifically evaluates the ease of navigating documentation and getting started workflows to identify potential onboarding blockers for new developers.