spec-writer

Convert rough repo change ideas into numbered spec folders with requirements, plans, and task lists.

14|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/mickpletcher/AI-Skills --skill spec-writer-mickpletcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writer
Source: https://github.com/mickpletcher/AI-Skills/tree/main/claude/skills/spec-writer
Command: npx skills add https://github.com/mickpletcher/AI-Skills --skill spec-writer-mickpletcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

spec-writer removes ambiguity from non-trivial repository changes by converting an idea or rough change description into a structured spec package that an engineer can execute with confidence.

Core Features & Use Cases

  • Numbered Spec Folder Planning: Creates the next numbered spec folder and ties the folder name to the actual work to keep repo workflow consistent.
  • Practical Planning Documents: Produces targeted requirements.md, plan.md, and tasks.md that define scope, constraints, sequencing, and validation instead of leaving it as informal notes.
  • Assumptions, Risks, and Alignment Checks: Forces explicit assumptions and re-checks that the spec matches the live repo conventions rather than generic templates.

Quick Start

Tell an AI to use spec-writer to generate the next numbered spec folder for the following repo change: describe what you want to change, the affected areas, and any constraints.

Frequently Asked Questions about spec-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create execution-ready specifications for large repository changes?

To create execution-ready specifications for large repository changes, convert rough ideas into a structured spec folder containing requirements.md, plan.md, and tasks.md to define scope, constraints, and ordered task lists.

What is the best way to break down a major software refactor into actionable tasks?

Breaking down a major software refactor into actionable tasks requires generating a numbered spec folder with a tasks.md file, ensuring explicit assumptions and acceptance criteria align with live repository conventions.

When do I need formal specification documents instead of ad hoc notes for a migration?

You need formal specification documents instead of ad hoc notes for a migration when the scope is too large, requiring clear requirements, implementation plans, and a validation checklist checked against the live repository.

How do I ensure implementation plans align with existing repo conventions?

To ensure implementation plans align with existing repo conventions, generate a spec package that forces explicit assumptions and re-checks the plan against the live repo conventions rather than applying generic templates.

Can I use a structured spec package for both feature work and workflow changes?

Yes, you can use a structured spec package for feature work, refactors, migrations, cleanups, and workflow changes, producing targeted requirements, plans, and task lists to remove ambiguity from non-trivial repository modifications.