sdd-docs

Create and maintain structured software design documentation with EARS notation.

7|4|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/windschord/claude_skils --skill sdd-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-docs
Source: https://github.com/windschord/claude_skils/tree/main/sdd-docs
Command: npx skills add https://github.com/windschord/claude_skils --skill sdd-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill eliminates common pitfalls in software development by providing a structured approach to documentation. It tackles ambiguous requirements, inconsistent design records, and unmanageable task breakdowns, ensuring clarity and traceability throughout your project. Stop wasting time on disorganized documentation and focus on building.

Core Features & Use Cases

  • Structured Documentation: Automatically sets up and manages requirements.md, design.md, and tasks.md in a dedicated docs directory. This ensures all critical project information is centralized and easily accessible.
  • Clear Requirements with EARS: Defines precise, testable requirements using the Easy Approach to Requirements Syntax (EARS) for user stories and acceptance criteria. This reduces ambiguity and improves communication.
  • Technical Design & Architecture: Documents your system's architecture, component designs, data models, and key technical decisions. This preserves institutional knowledge and streamlines onboarding.
  • Actionable Task Management: Breaks down features into granular, trackable tasks with clear acceptance criteria, dependencies, and status. This simplifies project planning and progress monitoring.
  • Use Case: Imagine you're kicking off a new API project. Use this Skill to define all API endpoints and their behaviors in requirements.md, design the database schema and service architecture in design.md, and then generate a detailed implementation plan in tasks.md, all while ensuring every step is clearly documented and traceable.

Quick Start

Initialize the docs directory for your project.

Frequently Asked Questions about sdd-docs

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

FAQPage Schema
How do I create structured software design documentation for my project?

Structured software design documentation organizes requirements, architecture, and tasks in a centralized docs folder. This Skill automatically sets up requirements.md, design.md, and tasks.md files, ensuring all critical project information is traceable and accessible throughout development.

What is EARS notation and why use it for requirements?

EARS (Easy Approach to Requirements Syntax) is a structured method for writing precise, testable user stories and acceptance criteria. It reduces ambiguity in requirements by enforcing consistent phrasing, improving communication between teams and making requirements easier to validate.

How do I break down features into manageable tasks with clear dependencies?

Task management in design documentation converts feature requirements into granular, trackable tasks with acceptance criteria and dependencies marked. This Skill generates an actionable implementation plan in tasks.md that simplifies project planning and enables progress monitoring.

Can I use design documentation for both new projects and ongoing improvements?

Yes, structured design documentation works for both new projects and incremental improvements. This Skill supports template-driven creation and edits across requirements, design, and tasks files, maintaining cross-document consistency whether you're starting fresh or enhancing existing systems.

What information should I document in a technical design file?

Technical design documentation captures system architecture, component designs, data models, and key technical decisions. This preserves institutional knowledge, streamlines developer onboarding, and ensures architectural decisions remain traceable and accessible to the team.

Why does disorganized documentation slow down software development?

Disorganized documentation leads to ambiguous requirements, inconsistent design records, and unmapped task breakdowns, creating rework and knowledge loss. Structured documentation eliminates these pitfalls by centralizing information, ensuring clarity, and maintaining traceability throughout the development lifecycle.