docs-ssotlisted
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