Agent skill

write-spec

Write a detailed feature specification from requirements. Use after shaping to create spec.md with goals, user stories, requirements, and technical approach.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/product/write-spec

SKILL.md

Write Spec

Create a comprehensive specification document from gathered requirements.

When to Use

  • Requirements are gathered in planning/requirements.md
  • Ready to document the technical specification
  • Need a clear spec before task breakdown

Workflow

  1. Analyze Inputs

    • Read amp-os/specs/[feature]/planning/requirements.md
    • Review any visuals in planning/visuals/
    • Load relevant standards skills

  2. Search for Reusable Code

    • Use finder to locate similar implementations
    • Document patterns to reuse
    • Note existing components to leverage

  3. Write Specification

    • Follow template exactly from spec-template.md
    • Save to amp-os/specs/[feature]/spec.md

  4. Generate Architecture Diagram

    • Load amp-os-architecture-diagrams skill
    • Create system/component diagram with mermaid

  5. Verify Spec Quality

    • Load amp-os-spec-verifier skill
    • Ensure completeness and feasibility

Important Constraints

  • Do NOT write actual code in spec.md
  • Keep sections concise and skimmable
  • Reference visual assets when available
  • Follow template structure exactly

Resources

  • Spec Template

Amp Tools to Use

  • finder - Find similar implementations
  • mermaid - Architecture diagrams
  • oracle - Review spec for completeness

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results