# Omcustomupdate Docs

> Sync documentation with project structure Use when this capability is needed.

- Skill: `tomevault-io/omcustomupdate-docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/omcustomupdate-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/omcustomupdate-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/omcustomupdate-docs

---


# Update Documentation Skill

Ensures all documentation (AGENT.md, SKILL.md, index.yaml, CLAUDE.md) accurately reflects the current project state and that agents work together organically.

## Options

```
--check, -c      Check only, don't modify
--verbose, -v    Show detailed changes
--target, -t     Specific target to update
```

## Workflow

```
1. Scan project structure
   ├── .claude/agents/
   ├── .claude/skills/
   ├── templates/guides/
   └── commands/

2. Validate consistency
   ├── Check agent files exist
   ├── Check skill references exist
   ├── Check guide references exist
   └── Check command definitions match files

3. Update documentation
   ├── Verify all .claude/agents/*.md files
   ├── Verify all .claude/skills/*/SKILL.md files
   ├── Update CLAUDE.md summary
   └── Update inter-agent references

4. Ensure organic integration
   ├── Verify agent → skill mappings
   ├── Verify agent → guide mappings
   ├── Verify command → agent mappings
   └── Check for orphaned resources
```

## What Gets Updated

### Agent Files
- All .claude/agents/*.md files exist and are valid
- No orphaned or missing agents
- Metadata is consistent

### Skill Files
- All .claude/skills/*/SKILL.md files exist
- Skill categories reflect actual structure
- References are valid

### CLAUDE.md
- Project structure diagram
- Agent/skill/guide counts
- Command list
- Summary tables

### Individual Agent/Skill Files
- Skill references in agent files
- Guide references in agent files
- Cross-agent references

## Organic Integration Checks

```yaml
agent_skill_mapping:
  - Each agent declares valid skills
  - Skills are in correct category
  - No duplicate skill declarations

agent_guide_mapping:
  - Each agent declares valid guides
  - Guides exist in templates/guides/
  - Paths are relative and correct

command_agent_mapping:
  - Commands reference valid agents
  - Agent capabilities match commands
  - Workflow is documented
```

## Output Format

### Check Mode
```
[/update-docs --check]

Scanning project structure...

Agents:
  ✓ 15 agents found in .claude/agents/
  ✗ Missing: lang-java21-expert.md (referenced but not found)

Skills:
  ✓ 13 skills found in .claude/skills/
  ✓ All SKILL.md files valid

Guides:
  ✓ 12 guides declared
  ✗ Orphan: templates/guides/old-guide/ (exists but not referenced)

CLAUDE.md:
  ✗ Agent count outdated (shows 14, actual 15)

Issues Found: 3
Run "/update-docs" to fix.
```

### Update Mode
```
[/update-docs]

Syncing documentation with project structure...

[1/3] Verifying agents
  - Removed reference: lang-java21-expert (not found)
  ✓ 15 → 14 agents

[2/3] Verifying skills
  ✓ No changes needed

[3/3] Updating CLAUDE.md
  - Updated agent count: 14 → 15
  - Updated summary table
  ✓ Synced

Summary:
  Modified: 1 file
  Removed: 1 reference

All documentation synced successfully.
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/baekenough) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-12 -->