📝
WritingJavaScript

Spec Writer

by MageByte-Zero

Spec Writer is a Writing skill for Claude Code, published by MageByte-Zero in spec-superflow.

759 stars75 forkson MageByte-Zero/spec-superflowAdded 2026/08/23+1% in starsRepository updated 2026/08/16
ai-codingamazon-qclaude-codeclinecodexcopilot-clicursorgemini-cliopencodeopensourceopenspecskillsspec-driven-developmentspec-firstsuperpowerstddtraewindsurfworkflow
Install in seconds
Install Spec Writer
Copy Spec Writer into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/MageByte-Zero/spec-superflow/tree/main/skills/spec-writer ~/.claude/skills/spec-writer

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/MageByte-Zero/spec-superflow.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/spec-writer/SKILL.md in MageByte-Zero/spec-superflow
Installs to
~/.claude/skills/spec-writer
Collection
One of 9 skills cataloged from this repository
Category
Writing1012 skills

What Spec Writer does

Spec Writer creates or refines planning artifacts for a change: proposal.md, specs/, design.md, and tasks.md. Use it after the change is understood enough to write testable specs and implementation tasks.

Spec Writer is cataloged under Writing on DirSkills. Spec Writer comes from a repository tagged ai-coding, amazon-q, claude-code, cline and codex.

Documentation

README

Spec Writer

Create or refine planning artifacts when the change has moved beyond exploration.

Required Inputs

Read .spec-superflow.yaml (especially dp_0_decisions, dp_0_confirmed) and any existing planning artifacts. If dp_0_confirmed is not true, stop and route back to workflow-start for DP-0.

Config Check

Run: ssf runtime config --get artifacts.order — generate in configured order (default: proposal → specs → design → tasks). Run with artifacts.skip — skip any listed artifacts.

Artifact Roles

  • proposal.md: why and scope
  • specs/: required behavior (testable)
  • design.md: architecture decisions and trade-offs (not line-by-line)
  • tasks.md: dependency-aware implementation steps

Working Rules

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Spec Writer

  • What else does MageByte-Zero publish alongside Spec Writer?

    Spec Writer is one of 9 skills that DirSkills catalogs from MageByte-Zero/spec-superflow, the repository it ships in. Its siblings there include Bug Investigator, Build Executor and Code Reviewer. Each one is a separate skill with its own page in this directory, installs the same way Spec Writer does, and is maintained by MageByte-Zero in that same repository. The rest of the collection is listed on the MageByte-Zero/spec-superflow page.

  • How does Spec Writer compare to other Writing skills?

    Spec Writer ranks #584 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Spec Writer against them. Open each page to compare what they document and how they install.

More from MageByte-Zero/spec-superflow

Spec Writer is one of 9 skills cataloged on DirSkills from MageByte-Zero/spec-superflow.

See all 9 skills