Technical Writing

Docs a new user can actually follow.

Test report

Verdict
Tested · Works
Score
8.8/10
Tested
Jun 18, 2026
Environment
Claude Code 2.x

Wrote setup docs for a real CLI tool; a new user followed them start-to-finish without getting stuck once.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 4/5
  • Output vs. baseline 9/10
  • Docs & honesty 4/5

What it does

Tutorials, how-tos, references and explanations with the right structure for each. Our test is brutal and simple: give the docs to someone new and watch where they get stuck. Nobody got stuck.

Install

Copy the skill folder into ~/.claude/skills/ and point Claude at the thing to document.

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Appears in