spec-writer

Generate minimal layered specifications for the Layered SDD framework.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/eruizc-dev/eruizc-dev --skill spec-writer-eruizc-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writer
Source: https://github.com/eruizc-dev/eruizc-dev/tree/main/dotfiles/.config/opencode/skills/spec-writer
Command: npx skills add https://github.com/eruizc-dev/eruizc-dev --skill spec-writer-eruizc-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a concise, universal approach to capturing requirements and constraints across all nine layers, reducing ambiguity and drift between planning and implementation.

Core Features & Use Cases

  • Minimal, layer-aware templates guiding work from Layer 1 (Functional/Business) through Layer 9 (Implementation).
  • Clear separation of concerns with focused content per layer (e.g., Layer 2 targets, Layer 3 UX wireframes, Layer 4 data entities, Layer 5 security, Layer 6 test strategy, Layer 7 architecture patterns, Layer 8 integration contracts, Layer 9 technology choices).
  • Living documents designed for collaboration and evolution as requirements change; easy reference for stakeholders.
  • Use Case: start a new feature spec by defining high-level goals in Layer 1, capture measurable targets in Layer 2, and outline the integration contracts in Layer 8.

Quick Start

Provide a requirement and let the AI generate minimal, layered specifications.

Frequently Asked Questions about spec-writer

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

FAQPage Schema
How do I write layered specifications for cross-functional teams?

Layered specifications separate concerns across business, UX, data, security, and architecture layers, guiding cross-functional teams with precise, non-implementation-focused requirements to reduce ambiguity and drift.

What is the best way to structure requirements across architecture and engineering layers?

Structuring requirements across architecture and engineering layers involves using minimal, layer-aware templates that target specific content like data entities, test strategy, and integration contracts to maintain clear separation of concerns.

How do I start a new feature spec using layered design?

To start a new feature spec using layered design, provide a high-level requirement to generate minimal specifications, defining functional goals first, then capturing measurable targets and outlining integration contracts.

Can I capture security and UX wireframes in the same specification document?

Yes, you can capture security and UX wireframes in the same living specification document, but they are separated into distinct layers to maintain focused content and prevent overlapping concerns.

Does layered specification work for defining integration contracts and test strategies?

Layered specification explicitly supports defining integration contracts in Layer 8 and outlining test strategy in Layer 6, ensuring these technical constraints are documented precisely without dictating implementation details.

When should I avoid using a nine-layer specification framework?

You should avoid using a nine-layer specification framework when a project requires immediate implementation without cross-functional alignment, as generating minimal layered specifications demands upfront architectural and requirement separation.