What is the purpose of the user-qa directory?

The user-qa directory is used to document questions, ambiguous requirements, and pending design choices that require explicit user approval or confirmation.

Where are design documents stored with this skill?

All design documents must be stored in specific subdirectories under design-docs/, such as specs/, references/, or user-qa/. Files should never be placed directly in the design-docs/ root.

What are the primary specification files used?

The skill focuses on three main files in the specs/ directory: command.md for CLI design, architecture.md for system structure, and notes.md for general research and findings.

How does this skill handle code examples in documentation?

It advocates for minimal code usage (ideally 10-20 lines), preferring pseudocode, type signatures, or direct links to source files to maintain readability and focus on design.

Structured Design Documentation

Name: Structured Design Documentation
Author: tacogips

bytacogips

0•

内容管理

Standardizes project design documentation through a hierarchical directory structure and concise formatting guidelines.

The design-doc skill provides a systematic framework for creating, organizing, and maintaining technical documentation within a project. It enforces a strict directory structure that separates core specifications, external references, and user Q&A items, ensuring that architectural decisions and CLI designs remain discoverable. By prioritizing conceptual clarity and providing templates for supporting documents, this skill helps teams avoid documentation rot and minimizes code noise in design specs.

主要功能

01Enforces a standardized directory hierarchy under design-docs/ for consistent navigation

02Provides predefined templates for detailed supporting design documents

030 GitHub stars

04Includes a dedicated user-qa workflow for tracking pending decisions and clarifications

05Implements guidelines for minimizing code bloat to keep focus on high-level design

06Categorizes core specifications into dedicated files for commands, architecture, and research notes

使用场景

01Managing CLI interface specifications and environment variable documentation

02Establishing a professional documentation standard for new software projects

03Recording complex architectural decisions and technical research results

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tacogips/moltbook-cli design-doc

For use in Claude.ai and ChatGPT