Developer Experience Review skill for Claude and Codex

Developer Experience Review as an AI skill. It asks for Product and audience, Entry points, Setup steps today and 3 more, then does the rest. Free to install…

Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.

Download the skill (.zip) · View SKILL.md

When it is used

Use when a maintainer wants to know why new developers struggle to install and use an SDK, API, or CLI and which fixes cut the time to first success. Do not use for writing API reference documentation or marketing copy. Related topics: coding, product.

What it will ask you for

• Product and audience (longer free text)
• Entry points (longer free text)
• Setup steps today (longer free text)
• Time to first success (free text, e.g. "Minutes you or a tester needed")
• Where people get stuck (longer free text)
• Package type (choose one: SDK, REST API, CLI, Framework, Template)

How it works

1. Follow the documented path as a first-time user and time each stage from finding the docs to seeing a result.
2. Record every friction point with the stage it occurred in and the exact text that caused it.
3. Rate quickstart, examples, error messages, and reference on a simple scale.
4. Rank fixes by minutes saved per developer against effort.
5. Rewrite the opening quickstart screen for the shortest route to a working result and set a target time.

What you get

A timed path table, a friction list, ratings for four documentation areas, a ranked fix list with effort, a rewritten quickstart opening, and a target time to first success.

What it watches out for

• Assuming tools the author has installed, so missing prerequisites never get reported.
• Judging docs by completeness instead of by whether the first call works verbatim.
• Listing every nit with equal weight rather than ranking by time saved.

How to install

Claude.ai and the Claude desktop app

1. Download the skill .zip.
2. Open Settings, then Capabilities, and find Skills.
3. Choose Upload skill and select the .zip.
4. Ask Claude for help with the task. It loads the skill when your request matches.

Claude Code

1. Download the skill .zip.
2. Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
3. Start a new session. Claude Code loads the skill when your request matches.

Codex

1. Download the skill .zip.
2. Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
3. Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.

Cursor

1. Download the Cursor rule (.mdc).
2. Save it in .cursor/rules/ inside your project.
3. Cursor's agent applies the rule when your request matches its description.

AGENTS.md (Codex, Cursor, and other coding agents)

1. Copy the AGENTS.md section.
2. Paste it into AGENTS.md at the root of your repository, creating the file if needed.
3. Coding agents that read AGENTS.md follow it when your request fits.