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.