spec

Transform handoff.md entries into structured spec documents with acceptance criteria.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/yearofthedan/weaver --skill spec-yearofthedan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/yearofthedan/weaver/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/yearofthedan/weaver --skill spec-yearofthedan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform handoff.md entries into structured, actionable design specs that guide implementation and alignment across teams.

Core Features & Use Cases

  • Pick the appropriate spec template from docs/specs/templates based on the handoff context.
  • Guide collaborative decision-making with the user to produce a complete spec with context, intent, and acceptance criteria.
  • Generate and store a ready-to-implement spec file under docs/specs with a timestamped filename.

Quick Start

Provide a handoff.md entry and confirm the spec workflow to generate a ready-to-implement spec file.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn handoff notes into structured design specs for implementation?

To turn handoff notes into structured design specs, provide a handoff.md entry and the system selects an appropriate template, guiding decision-making to produce a ready-to-implement spec file with context and acceptance criteria.

What is the best way to document design decisions and requirements during a project handoff?

Documenting design decisions and requirements during a project handoff works best by transforming handoff entries into standardized spec documents, ensuring open decisions are noted and alignment is achieved across teams before implementation begins.

How do I generate spec documents with acceptance criteria from a handoff entry?

Generate spec documents with acceptance criteria from a handoff entry by confirming the spec workflow, which applies a step-based process to produce a timestamped file under docs/specs containing intent, context, and actionable acceptance criteria.

Do I need pre-existing spec templates to use the spec generation workflow?

Yes, the spec generation workflow selects from spec templates stored under docs/specs/templates, matching the appropriate template to your handoff context to ensure the resulting documentation follows standardized formatting.

Can I use this spec workflow for both design planning and implementation planning?

Yes, you can use this spec workflow for both design and implementation planning, as it handles a range of handoff entries and applies a guided, step-based process to produce structured documentation for alignment and execution.

Why does the spec generation process require user confirmation during the workflow?

The spec generation process requires user confirmation to enforce a collaborative, step-based decision-making workflow, ensuring open decisions are explicitly noted and the final spec document accurately reflects team alignment before implementation.