One-click install
npx skills add https://github.com/ZaxbyHub/opencode-swarm --skill design-docs-zaxbyhub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-docs
Source: https://github.com/ZaxbyHub/opencode-swarm/tree/main/.opencode/skills/design-docs
Command: npx skills add https://github.com/ZaxbyHub/opencode-swarm --skill design-docs-zaxbyhub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the pain of inconsistent, outdated, and misaligned project design documentation, which causes team misalignment, unclear requirements, and drift between planned architecture and actual codebase implementation.

Core Features & Use Cases

  • Structured Design Doc Generation: Creates language-agnostic, version-controlled design docs including domain specs, technical specifications, behavior specs, and reference materials, all with stable section IDs and traceability to project requirements.
  • Automated Doc Sync: Updates existing design docs to match current code and spec changes during development phases, preventing design drift without manual maintenance.
  • Use Case: A software team building a new user authentication feature can use this Skill to generate aligned design docs on project kickoff, then automatically sync those docs as the implementation evolves to keep all stakeholders aligned.

Quick Start

Use the design-docs skill to generate a full set of structured design docs for the current project's new user authentication feature.

Frequently Asked Questions about design-docs

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

FAQPage Schema
How do I prevent design drift between project specifications and codebase implementation?

To prevent design drift, use automated doc sync to continuously update structured project design documentation, ensuring technical specifications remain aligned with current code and functional requirements during development.

How do I generate structured technical specifications with traceability to functional requirements?

Generate technical specifications with traceability by automating structured design doc creation, which assigns stable section IDs and links domain specs, behavior specs, and reference materials directly to functional requirements.

What is the best way to maintain version-controlled design documentation for software architecture?

The best way to maintain version-controlled design documentation is automating language-agnostic doc generation and sync, which enforces consistency and tracks architectural changes alongside project specifications without manual updates.

Does automated design documentation work for both new project initialization and ongoing development phases?

Automated design documentation applies to both new project initialization and ongoing development phases, generating initial structured specs and automatically syncing design artifacts as the codebase evolves to keep stakeholders aligned.

Why does implementation drift happen and how can requirements traceability fix it?

Implementation drift happens when architecture plans and code diverge. Requirements traceability fixes this by enforcing stable section IDs and automated drift detection, maintaining strict consistency between design artifacts and actual implementation.

Can I use language-agnostic design docs for software architecture instead of framework-specific documentation?

Yes, you can use language-agnostic design docs for software architecture. They provide normative domain and behavior specs with enforced consistency, ensuring broad accessibility regardless of the specific programming frameworks used.