Dx Audit

Audit the developer experience of a developer tool (SDK, API, CLI, framework) by trying it exactly like a brand-new developer, from the official docs only, in a fresh empty environment. Logs every step with timestamps and friction tags, measures time to first success, steps, page switches, errors and lines of code, finds where people would give up, grades three error messages, and writes a fair teardown with the top 5 fixes as ready-to-paste doc and error rewrites. Use when the user says "audit the developer experience of X", "DX teardown", "DX audit", "try this SDK like a new user", "onboardi

517 stars 39 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add dotslashsimran/simcraft --skill dx-audit
Manual install
git clone --depth 1 https://github.com/dotslashsimran/simcraft.git /tmp/simcraft
mkdir -p ~/.claude/skills
cp -r /tmp/simcraft/skills/coding/dx-audit ~/.claude/skills/dx-audit

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# DX audit

You play a competent developer who has never seen this tool. You follow the official docs literally, write down everything that happens, and turn it into a teardown the company's DevRel team would want to read. The output is evidence, not opinion: every complaint has a timestamp, a URL, the exact output, and a fix.

Scripts (Python is standard library only, Node uses the repo's `playwright`):
```
python3 ~/simcraft/skills/coding/dx-audit/scripts/friction.py   # written "friction.py" below
node ~/simcraft/skills/coding/dx-audit/scripts/snapshot.mjs      # written "snapshot.mjs" below
```
If `playwright` does not resolve, run `npm install` in `~/simcraft` once. Read `reference.md` for the tag definitions, grading rubric, time model and a worked example.

## 1. Set up (ask the user, one question at a time)

1. **The tool and ONE goal.** A real first task, such as "send my first traced LLM call", "deploy hello world", "create a project and add a package". Not "evaluate everything".
2. **Success, defined before you start.** One observable result: an exact output, an HTTP 200, a trace visible in a dashboard. Write it down. Do not change it halfway to make the run look better.
3. **The entry point.** Where a newcomer lands: usually the docs home or the "Quickstart" link on the homepage.

## 2. A clean environment

- A fresh empty temp folder, never inside a real project.
Read the full skill on GitHub

Details

Skill name
dx-audit
Path
skills/coding/dx-audit/SKILL.md
License
MIT
Repo updated
9 November 2026

FAQ

What does the Dx Audit skill do?

Audit the developer experience of a developer tool (SDK, API, CLI, framework) by trying it exactly like a brand-new developer, from the official docs only, in a fresh empty environment. Logs every step with timestamps and friction tags, measures time to first success, steps, page switches, errors and lines of code, finds where people would give up, grades three error messages, and writes a fair teardown with the top 5 fixes as ready-to-paste doc and error rewrites. Use when the user says "audit the developer experience of X", "DX teardown", "DX audit", "try this SDK like a new user", "onboardi

How do I install the Dx Audit skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add dotslashsimran/simcraft --skill dx-audit. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Dx Audit popular?

It lives in dotslashsimran/simcraft, which has 517 GitHub stars and 39 forks.

Related skills

API Design Review

517

dotslashsimran/simcraft

Review the design of an API surface, meaning an HTTP API (OpenAPI spec or route code), an SDK's public classes and functions, or a CLI. Checks naming and consistency, resource modelling, error design (stable codes, RFC 9457 problem details, request ids), versioning and breaking changes, pagination, filtering, idempotency and retries, rate limits, timeouts, long-running operations, webhooks, auth, partial updates, ID, time and money formats, SDK ergonomics and CLI conventions. Uses scripts to lint OpenAPI files, classify changes between two spec versions as breaking or safe, and dump an SDK's p

Software Development39

Benchmark Honestly

517

dotslashsimran/simcraft

Build benchmarks that survive scrutiny and catch the classic lies (dead code elimination, lazy results, constant folding, warm caches, coordinated omission, averages hiding GC pauses, unequal work, noisy machines). Defines the question first, controls and discloses the environment, uses warmups, interleaved repeats, medians, bootstrap confidence intervals and Mann-Whitney tests, and ends with a one-line verdict that includes the CI. Bundles a command runner, an environment reporter and an open-loop latency tester. Use when the user says "benchmark this", "is this faster", "compare performance"

Software Development39

Bisect Anything

517

dotslashsimran/simcraft

Find the exact commit (or dependency version, config value, or input) that caused a regression by turning it into an automatic pass/fail check and running git bisect run in a separate worktree, then shrink the bad commit to the hunk that matters and explain it. Handles failing tests, changed output, slowdowns, crashes, visual changes, server behaviour, flaky checks, unbuildable commits and merge-heavy history. Use when the user says "what broke this", "find the commit that", "when did this start", "it used to work", "regression", "git bisect", "which version broke it", or "which change made it

Git & Code Review39

Emulo

306

ohad6k/emulo

Load the user's Emulo profile, rules mined from their own local AI coding session logs (Claude Code, Codex, Copilot CLI, OpenCode, Google Antigravity), each with dated quotes. Read it before working on their task.

Software DevelopmentIn 1 list31

Codebase Map

517

dotslashsimran/simcraft

Understand an unfamiliar codebase fast, the way senior engineers do. Reads the orientation signals (README, manifests, CI, Dockerfiles, routes, migrations), mines git history for hotspots, hidden coupling and ownership, builds the import graph to find layers, cycles, load-bearing and dead code, then traces one real request or command end to end by actually running it. Writes MAP.md with a one-paragraph purpose, a Mermaid architecture diagram, the traced path as file:line hops, hotspot and coupling tables, a glossary, gotchas and first tasks, plus an optional SVG. Use when the user says "explai

Software Development39

Birdeye API

564

agiprolabs/claude-trading-skills

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

Software Development113

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.