spec-writing

Create and refine feature specifications using canonical templates and quality checklists.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/zeeshan080/ezee-erp --skill spec-writing-zeeshan080
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/zeeshan080/ezee-erp/tree/main/.claude/skills/spec-writing
Command: npx skills add https://github.com/zeeshan080/ezee-erp --skill spec-writing-zeeshan080

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

This Skill enables the Spec Writer agent to create and refine feature specifications from vague briefs by leveraging canonical templates, structured clarification workflows, and comprehensive quality checklists, reducing ambiguity and rework across teams.

Core Features & Use Cases

  • Template-driven spec creation: apply canonical templates and reference patterns to produce clear, testable specs.
  • Clarification workflows: run targeted clarification sessions to resolve ambiguities and align stakeholders.
  • Quality validation: validate specs against taxonomy, requirement patterns, and quality criteria.
  • Reference-guided drafting: consult taxonomy and guidance documents to ensure completeness and consistency.

Quick Start

Load the canonical spec template from .specify/templates/spec-template.md, reference materials in references/ (e.g., spec-taxonomy.md, requirement-patterns.md, clarification-guide.md), and use assets (templates for user stories and quality checklists) as you draft and validate the specification.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I turn vague briefs into testable feature specifications?

To turn vague briefs into testable feature specifications, apply canonical spec templates and run structured clarification sessions to resolve ambiguities, ensuring outputs are complete and implementation-agnostic.

What is the best way to write user stories with acceptance criteria?

The best way to write user stories with acceptance criteria is using template-driven spec creation assets that enforce requirement patterns, ensuring each story is testable, complete, and aligned across functional and non-functional concerns.

How do I run a clarification session to resolve specification ambiguities?

Run a clarification session to resolve specification ambiguities by following a targeted clarification guide that identifies gaps in vague briefs and aligns stakeholders on functional, non-functional, and integration requirements.

How do I validate feature specs against quality checklists?

Validate feature specs against quality checklists by applying taxonomy and requirement pattern references to check completeness across functional, non-functional, and integration concerns, ensuring specs are testable and implementation-agnostic.

Do I need any specific dependencies to start spec writing?

No specific dependencies are required to start spec writing. The workflow uses built-in canonical templates, taxonomy references, and quality checklist assets to guide drafting and validating specifications independently.