spec-writing

Write complete specification documents across IA, BE, and FE layers.

6|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill spec-writing-repairyourtech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/RepairYourTech/cfsa-antigravity/tree/main/.agent/skills/spec-writing
Command: npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill spec-writing-repairyourtech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that specification documents are complete, unambiguous, and adhere to a consistent methodology, preventing costly errors and rework downstream.

Core Features & Use Cases

  • Progressive Writing: Guides the user to write one section at a time, ensuring each part is fully defined before moving on.
  • Completeness Testing: Implements a two-implementer test to verify that each section is clear enough for independent developers to produce the same implementation.
  • Cross-Reference Validation: Mandates checks between different specification layers (IA, BE, FE) to identify and document coverage gaps.
  • Ambiguity Gate: Provides a clear mechanism to halt the process and seek user clarification when requirements are unclear or have multiple valid interpretations.
  • Use Case: When writing a new API endpoint specification, this skill ensures all fields, responses, errors, and permissions are meticulously defined, preventing misunderstandings between backend and frontend teams.

Quick Start

Use the spec-writing skill to draft the 'user-authentication' section of the BE specification, ensuring all fields, endpoints, and permissions are fully detailed.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I write unambiguous technical specifications for frontend and backend layers?

To write unambiguous specifications, use a progressive section-by-section methodology for Information Architecture, Backend, and Frontend layers, ensuring fields, endpoints, and permissions are fully defined before moving forward.

What is the best way to validate specification completeness for API endpoints?

Validating specification completeness is best achieved by implementing a two-implementer test, which verifies that a section is clear enough for independent developers to produce the exact same implementation.

How do I handle ambiguity and unclear requirements during specification writing?

To handle ambiguity during specification writing, the process triggers an ambiguity gate that halts writing and prompts the user to provide clarification when requirements have multiple valid interpretations.

How do I check cross-references between Information Architecture, Backend, and Frontend specs?

Checking cross-references between IA, BE, and FE specifications requires mandated validation across layers to identify coverage gaps, ensuring all state transitions and elements align correctly.

Does this specification writing method enforce a specific quality rubric for documentation?

Yes, this specification writing method enforces a strict quality rubric within a Constraint-First Specification Architecture pipeline, governing progressive writing and cross-reference validation to prevent downstream errors.

What should I do if my specification documents have coverage gaps between layers?

If specification documents have coverage gaps between layers, you should run cross-reference validation checks to identify and document the missing elements before proceeding to the next section.