devdocs-system-design

Create or update system design documentation from requirements files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ab300819/skills --skill devdocs-system-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devdocs-system-design
Source: https://github.com/ab300819/skills/tree/main/devdocs-system-design
Command: npx skills add https://github.com/ab300819/skills --skill devdocs-system-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly create or update comprehensive system design documents from requirements, enabling clear architecture decisions, API design guidance, data modeling, and impact analysis.

Core Features & Use Cases

  • Initial Design: Generate a complete system design document when none exists, based on the requirements.
  • Incremental Design: Update diagrams, interfaces, and data models as features evolve or insights emerge.
  • Guidance & Compliance: Ensure changes are traceable to requirements, with impact analysis and compatibility checks.
  • Use Case: After finalizing a new feature, generate design artifacts and publish them in docs/devdocs/02-system-design.md.

Quick Start

Use the devdocs-system-design skill to create or update docs/devdocs/02-system-design.md based on docs/devdocs/01-requirements.md.

Frequently Asked Questions about devdocs-system-design

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

FAQPage Schema
How do I generate system design documentation from software requirements?

To generate system design documentation, provide a requirements document at docs/devdocs/01-requirements.md and the skill outputs a comprehensive design at docs/devdocs/02-system-design.md. It covers architecture, API design, data models, and impact analysis.

Can I update my existing architecture diagrams when new features are added?

Yes, you can update existing architecture diagrams incrementally as features evolve or insights emerge. The system design process modifies interfaces, data models, and diagrams while ensuring changes are traceable to requirements.

What do I need to create a full system design with API and data specifications?

You need a finalized requirements document placed at docs/devdocs/01-requirements.md. Using this input, the system design generation outputs the main design file along with optional API and data specification files.

What is the best way to trace architecture decisions back to original requirements?

The best way to trace architecture decisions is through incremental design updates that include impact analysis and compatibility checks. This ensures every API design and data model modification remains traceable to the requirements document.

Does system design generation work for both initial creation and incremental updates?

Yes, system design generation supports both initial design creation when no design exists and incremental design updates when changes arise from new features. It outputs architecture guidance and impact analysis for both scenarios.