← ClaudeAtlas

docs-ssotlisted

Set up docs-ssot SSOT documentation structure — migrate existing docs, build, and validate
hiromaily/claude-forge · ★ 1 · Data & Documents · score 68
Install: claude install-skill hiromaily/claude-forge
# docs-ssot: Documentation SSOT Setup This skill migrates existing Markdown documentation into a modular Single Source of Truth (SSOT) structure managed by `docs-ssot`, then builds and validates the output. ## When to use this skill - You have existing documentation (README.md, CLAUDE.md, AGENTS.md, etc.) to manage as SSOT - You want to set up `docs-ssot` in a new or existing repository - You want to regenerate documentation after editing source templates --- ## Workflow ### Step 1 — Check prerequisites Verify `docs-ssot` is installed: ```sh docs-ssot version ``` If not installed: ```sh # Homebrew (macOS/Linux) brew tap hiromaily/tap && brew install docs-ssot # or Go install go install github.com/hiromaily/docs-ssot/cmd/docs-ssot@latest ``` --- ### Step 2 — Identify existing documentation files List Markdown files in the repository root: ```sh ls *.md ``` Common candidates: `README.md`, `CLAUDE.md`, `AGENTS.md`, `CONTRIBUTING.md` --- ### Step 3 — Preview the migration plan Run a dry-run to see what sections will be created without writing any files: ```sh docs-ssot migrate --dry-run README.md CLAUDE.md ``` Review the output to understand: - How many sections will be created and their categories - Which sections are detected as duplicates (shared across files) - The proposed template structure under `template/sections/` and `template/pages/` --- ### Step 4 — Run the migration Migrate the identified files: ```sh docs-ssot migrate README.md CLAUDE.md AGE