name: docs-generator scope: uds-specific description: | Generate usage documentation from project sources. Use when: "generate docs", "create cheatsheet", "usage guide", "feature reference", "list all features" Keywords: documentation, usage, reference, cheatsheet, features, 功能文件, 速查表, 使用說明

Documentation Generator Skill

Language: English | 繁體中文

Version: 1.0.0 Last Updated: 2026-01-26 Applicability: Claude Code Skills

Purpose

Automatically generate comprehensive usage documentation from project source files. This skill creates:

FEATURE-REFERENCE.md: Complete feature documentation with all details
CHEATSHEET.md: Single-page quick reference table

Supports multiple languages (English, Traditional Chinese, Simplified Chinese) and scans various sources:

CLI commands
Slash commands
Skills
Agents
Workflows
Core standards
Scripts

Quick Reference

Generate All Documentation

node scripts/generate-usage-docs.mjs

Generate Specific Language

node scripts/generate-usage-docs.mjs --lang=en       # English only
node scripts/generate-usage-docs.mjs --lang=zh-TW    # Traditional Chinese
node scripts/generate-usage-docs.mjs --lang=zh-CN    # Simplified Chinese

Generate Specific Format

node scripts/generate-usage-docs.mjs --cheatsheet    # Cheatsheet only
node scripts/generate-usage-docs.mjs --reference     # Reference only

Check Sync Status

# Check if docs need update
node scripts/generate-usage-docs.mjs --check

# Or use sync check script
./scripts/check-usage-docs-sync.sh         # Check
./scripts/check-usage-docs-sync.sh --fix   # Fix if needed

Configuration

The generator uses .usage-docs.yaml in project root to define:

Output paths: Where to generate documents
Languages: Which languages to generate
Sources: What to scan (CLI, skills, commands, etc.)
Templates: Document structure templates

Configuration Example (Multi-language)

# .usage-docs.yaml - Full UDS configuration
version: "1.0"
output:
  directory: "docs/"
  formats: [reference, cheatsheet]
  languages: [en, zh-TW, zh-CN]
  paths:
    en: "docs/"
    zh-TW: "locales/zh-TW/docs/"
    zh-CN: "locales/zh-CN/docs/"

sources:
  cli:
    enabled: true
    entry: "cli/bin/uds.js"
  skills:
    enabled: true
    directory: "skills/claude-code/"
    pattern: "**/SKILL.md"

Single-Language Project

For projects that only need English documentation:

# .usage-docs.yaml - English only
version: "1.0"
output:
  directory: "docs/"
  formats: [reference, cheatsheet]
  languages:
    - en
  paths:
    en: "docs/"

sources:
  cli:
    enabled: true
    entry: "src/cli.js"

Custom Language Configuration

For projects with different language requirements (e.g., English + Japanese):

# .usage-docs.yaml - English + Japanese
version: "1.0"
output:
  directory: "docs/"
  formats: [reference, cheatsheet]
  languages:
    - en
    - ja
  paths:
    en: "docs/"
    ja: "docs/ja/"

templates:
  reference:
    title:
      en: "My Project Reference"
      ja: "プロジェクトリファレンス"
  cheatsheet:
    title:
      en: "My Project Cheatsheet"
      ja: "チートシート"

Configuration Fallback Behavior

The generator implements smart fallback for titles and paths:

Priority	Source	Description
1	`config[lang]`	Configured value for specific language
2	`config.en`	English fallback from config
3	Built-in default	Hardcoded default for supported languages

Supported built-in languages: en, zh-TW, zh-CN

For unsupported languages, you must provide custom titles in the templates section.

Output Files

Language	FEATURE-REFERENCE	CHEATSHEET
English	`docs/FEATURE-REFERENCE.md`	`docs/CHEATSHEET.md`
繁體中文	`locales/zh-TW/docs/FEATURE-REFERENCE.md`	`locales/zh-TW/docs/CHEATSHEET.md`
简体中文	`locales/zh-CN/docs/FEATURE-REFERENCE.md`	`locales/zh-CN/docs/CHEATSHEET.md`

Integration with Pre-Release Check

Add usage docs sync check to pre-release-check.sh:

# Check usage docs sync
echo "Checking usage documentation sync..."
./scripts/check-usage-docs-sync.sh

Workflow

┌─────────────────────────────────────────────────────────┐
│                    Documentation Generator               │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  1. Load Configuration (.usage-docs.yaml)               │
│           │                                              │
│           ▼                                              │
│  2. Scan Sources                                         │
│     ├─ CLI commands (uds.js)                            │
│     ├─ Skills (SKILL.md files)                          │
│     ├─ Commands (slash commands)                        │
│     ├─ Agents (agent definitions)                       │
│     ├─ Workflows (workflow files)                       │
│     ├─ Core standards (core/*.md)                       │
│     └─ Scripts (scripts/*.sh)                           │
│           │                                              │
│           ▼                                              │
│  3. Generate Documents                                   │
│     ├─ FEATURE-REFERENCE.md (detailed)                  │
│     └─ CHEATSHEET.md (quick reference)                  │
│           │                                              │
│           ▼                                              │
│  4. Output for Each Language                             │
│     ├─ English (docs/)                                   │
│     ├─ zh-TW (locales/zh-TW/docs/)                      │
│     └─ zh-CN (locales/zh-CN/docs/)                      │
│                                                          │
└─────────────────────────────────────────────────────────┘

Extending for Other Projects

This skill is designed to be reusable. To use in your project:

Copy the configuration template:

cp .usage-docs.yaml your-project/.usage-docs.yaml

Modify for your project structure:
- Update source directories
- Adjust patterns for your file naming
- Configure output paths

Copy the generator script:

cp scripts/generate-usage-docs.mjs your-project/scripts/

Run the generator:
```
node scripts/generate-usage-docs.mjs
```

Related Standards

Version History

Version	Date	Changes
1.0.0	2026-01-26	Initial release with multi-language support

License

This skill is released under CC BY 4.0.

Source: universal-dev-standards

Name	docs-generator
Description	Generate usage documentation from project sources. Use when: "generate docs", "create cheatsheet", "usage guide", "feature reference", "list all features" Keywords: documentation, usage, reference, cheatsheet, features, 功能文件, 速查表, 使用說明