How do I install the Devex Review skill?

Run npx skillmds@latest add cogine-ai/devex-review in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Devex Review safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Devex Review?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Devex Review free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Devex Review?

cogine-ai (@cogine-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Devex Review by cogine-ai — Agent Skill

Name: Devex Review
Author: cogine-ai

File contents

DevEx Review

Use this skill to test the implemented developer experience from the perspective of a new developer. This is a live audit, not a plan review.

Core Rule

Measure actual friction. Prefer running the quickstart, CLI help, examples, API requests, docs navigation, and error paths over judging intent from prose.

Scope

Use this for developer-facing products:

API onboarding and reference docs.
CLI install, help text, commands, flags, and errors.
SDK install/import/example flows.
MCP servers, plugins, agent skills, templates, or integration guides.
"Try the onboarding", "test the DX", "measure time to hello world", or "audit developer docs" requests.

Do not use this for end-user web UX, landing-page copy alone, or implementation-plan review before anything exists. Use plan-devex-review for plan-stage API/CLI/docs design.

Workflow

Define the developer persona.
- First-time evaluator, integrating engineer, internal maintainer, API customer, plugin author, or open-source contributor.
- State what they already know, expect, and how much setup they tolerate.
Measure TTHW.
- TTHW means time to a credible first successful result.
- Count steps, commands, accounts, tokens, config files, and decision points.
- Note where a real developer would abandon.
Test the core path.
- Run without insider knowledge; record timing, evidence, confusion, and abandonment points.
- Discover.
- Install and configure.
- Reach Hello World or the first useful output.
- Complete the first real task.
- Debug and recover from failure.
- Upgrade or complete the next likely task.
Test failure paths.
- Missing credential.
- Invalid input.
- Network/provider failure.
- Permission error.
- Version mismatch.
- Rate limit or quota issue if relevant.
Score the experience.
- TTHW.
- Setup clarity.
- Error quality.
- Example correctness.
- API/CLI surface coherence.
- Troubleshooting path.
- Trust and production readiness.

Scorecard

Dimension	Score	Evidence
Time to hello world	0-10
Setup clarity	0-10
Error quality	0-10
Examples and docs	0-10
API/CLI coherence	0-10
Troubleshooting	0-10
Production trust	0-10

Report Contract

## Developer Experience Review

### Target
Product:
Surface: API / CLI / SDK / docs / MCP / plugin / template
Persona:

### Summary
Overall score: __/10
TTHW measured:
Status: Ready / Usable with friction / Not ready

### Journey Tested
- <journey>

### Findings

#### DX-001: <title>
Severity:
Evidence:
Developer impact:
Recommended fix:

### Scorecard
<table>

### Not Tested
- <area>

### Recommended Next Step
- <next step>

Quality Bar

Distinguish tested behavior from inferred judgment.
Include exact commands, URLs, docs pages, or error text when available.
Do not optimize for aesthetic docs alone; measure whether a developer can succeed.
Call out boomerang gaps: where the intended plan says "easy" but the actual path is longer or unclear.

---name: devex-reviewdescription: Audit implemented APIs, CLIs, SDKs, MCP servers, plugins, docs, or onboarding for real developer friction.---# DevEx ReviewUse this skill to test the implemented developer experience from the perspective of a new developer. This is a live audit, not a plan review.## Core RuleMeasure actual friction. Prefer running the quickstart, CLI help, examples, API requests, docs navigation, and error paths over judging intent from prose.## ScopeUse this for developer-facing products:- API onboarding and reference docs.- CLI install, help text, commands, flags, and errors.- SDK install/import/example flows.- MCP servers, plugins, agent skills, templates, or integration guides.- "Try the onboarding", "test the DX", "measure time to hello world", or "audit developer docs" requests.Do not use this for end-user web UX, landing-page copy alone, or implementation-plan review before anything exists. Use `plan-devex-review` for plan-stage API/CLI/docs design.## Workflow1. Define the developer persona. - First-time evaluator, integrating engineer, internal maintainer, API customer, plugin author, or open-source contributor. - State what they already know, expect, and how much setup they tolerate.2. Measure TTHW. - TTHW means time to a credible first successful result. - Count steps, commands, accounts, tokens, config files, and decision points. - Note where a real developer would abandon.3. Test the core path. - Run without insider knowledge; record timing, evidence, confusion, and abandonment points. - Discover. - Install and configure. - Reach Hello World or the first useful output. - Complete the first real task. - Debug and recover from failure. - Upgrade or complete the next likely task.4. Test failure paths. - Missing credential. - Invalid input. - Network/provider failure. - Permission error. - Version mismatch. - Rate limit or quota issue if relevant.5. Score the experience. - TTHW. - Setup clarity. - Error quality. - Example correctness. - API/CLI surface coherence. - Troubleshooting path. - Trust and production readiness.## Scorecard| Dimension | Score | Evidence ||---|---:|---|| Time to hello world | 0-10 | || Setup clarity | 0-10 | || Error quality | 0-10 | || Examples and docs | 0-10 | || API/CLI coherence | 0-10 | || Troubleshooting | 0-10 | || Production trust | 0-10 | |## Report Contract```markdown## Developer Experience Review### TargetProduct:Surface: API / CLI / SDK / docs / MCP / plugin / templatePersona:### SummaryOverall score: __/10TTHW measured:Status: Ready / Usable with friction / Not ready### Journey Tested- <journey>### Findings#### DX-001: <title>Severity:Evidence:Developer impact:Recommended fix:### Scorecard<table>### Not Tested- <area>### Recommended Next Step- <next step>```## Quality Bar- Distinguish tested behavior from inferred judgment.- Include exact commands, URLs, docs pages, or error text when available.- Do not optimize for aesthetic docs alone; measure whether a developer can succeed.- Call out boomerang gaps: where the intended plan says "easy" but the actual path is longer or unclear.

Frequently asked questions

Devex Review