local-docs-validatelisted
Install: claude install-skill tatsushige-i/shared-claude-code
# Documentation Validation Skill
Validate documentation consistency across the shared-claude-code repository. Scan skills, rules, symlinks, README structure sections, and Japanese translations to detect inconsistencies. Offer automatic fixes where possible.
## Steps
### Step 1: Scan Skills
1. List all directories under `skills/` (excluding `README.md`)
2. For each skill directory, verify:
- **1-1 SKILL.md exists with frontmatter**: `skills/<name>/SKILL.md` exists and contains `name` and `description` in YAML frontmatter
- **1-2 Symlink exists**: `.claude/skills/<name>` exists as a symlink pointing to `../../skills/<name>`
- Check with `readlink .claude/skills/<name>`
- If the symlink does not exist or points to a different target → flag as issue
- **1-3 README table entry**: `skills/README.md` contains a row with the skill name in the skills table
- Check with `grep` for the skill name in `skills/README.md`
- **1-4 Japanese translation**: `docs/ja-JP/skills/<name>/SKILL.md` exists
3. Record each issue found with its category and details
### Step 2: Scan Rules
1. List all `.md` files under `rules/` (excluding `README.md` if present)
2. For each rule file, verify:
- **2-1 Japanese translation**: `docs/ja-JP/rules/<filename>` exists
3. Record each issue found
### Step 2b: Scan Agents
1. List all `.md` files under `agents/` (excluding `README.md`). If the `agents/` directory does not exist, skip this step.
2. For each agent file, verify:
-