Specification Writer

Category: Content · Sub-category: content-misc

Write and save structured specifications that pass the Stranger Test — precise enough for someone with zero context to evaluate agent output. Produces spec files in $HOME/.ai-first-kit/ at task, workflow, or governance layers, aligned with the organizational genome. Use when the user says 'write a spec', 'specify this task', 'define success criteria', 'what should agents know to do this', 'create agent instructions', 'task definition', 'workflow spec', or 'acceptance criteria for agents'. Also use when the user wants to document a repeatable process, create reusable agent prompts, turn a one-off task into a template, or define any work for autonomous agent execution — even if they don't use the word 'specification'. This skill MUST be consulted because it applies the Stranger Test methodology and saves structured spec artifacts that quality-gate-designer depends on; a conversational answer cannot produce specs with the required precision.

What this skill does

Specification Writer is a community-contributed Claude Code skill in the content-misc sub-category. It ships as a SKILL.md file that Claude Code auto-discovers under ~/.claude/skills/specification-writer/ and loads when your prompt matches the skill's trigger.

When to invoke it: Use when the user says 'write a spec', 'specify this task', 'define success criteria', 'what should agents know to do this', 'create agent instructions', 'task definition', 'workflow spec', or 'acceptance criteria for agents'. Also use when the user wants to document a repeatable process, create reusable agent prompts, turn a one-off task into a template, or define any work for autonomous agent execution — even if they don't use the word 'specification'.

Who uses this skill

The Specification Writer skill is built for content creators, marketers, copywriters, SEO professionals, and editorial teams. It is part of the open ClaudSkills registry, a community-curated catalog of 56,000+ capabilities you can install for Claude Code — the Claude CLI agent.

How to install

Free

Manual install (2 steps)

mkdir -p ~/.claude/skills/specification-writer
curl -L https://claudskills.com/skills/specification-writer/SKILL.md \
  -o ~/.claude/skills/specification-writer/SKILL.md

Or just download SKILL.md directly and drop it into ~/.claude/skills/specification-writer/. Claude Code auto-discovers it on next session.

Skills live at ~/.claude/skills/specification-writer/SKILL.md on macOS/Linux, or %USERPROFILE%\.claude\skills\specification-writer\SKILL.md on Windows. See the full install guide for step-by-step instructions.

Pro

One-click install via the desktop app

The ClaudSkills desktop app installs any skill directly into ~/.claude/skills/ with one click — no terminal required. Pro starts at $9/mo or $149 lifetime.

Pro

For the full experience including quality scoring and one-click install features for each skill — upgrade to Pro.

See pricing → Download desktop app