docs(docs): clarify skills sync workflow in documentation

docs/ai/index.mdx

@@ -15,7 +15,7 @@ The repo manages configuration for two coding agents and a skill library they sh
     Config, keybindings, MCP servers, theme, commands, and scheduled research loops under `~/.omp`.
   </Card>
   <Card title="Skills" href="/ai/skills" icon="library">
-    The `~/.agents/skills` library, its lock file, and the symlinks that expose it to Claude Code.
+    Agent skills declared in `.chezmoidata/skills.yaml` and installed into `~/.agents/skills` and `~/.claude/skills` by an apply script.
   </Card>
 </CardGroup>
 
@@ -23,9 +23,9 @@ The repo manages configuration for two coding agents and a skill library they sh
 
 | Page | Source in repo | Target in `$HOME` | Covers |
 | --- | --- | --- | --- |
-| [Claude Code](/ai/claude-code) | `dot_claude/` | `~/.claude/` | `settings.json`, hook scripts, `/commands`, empty `CLAUDE.md`, skill symlinks |
+| [Claude Code](/ai/claude-code) | `dot_claude/` | `~/.claude/` | `settings.json`, hook scripts, `/commands`, empty `CLAUDE.md` |
 | [omp](/ai/omp) | `dot_omp/` | `~/.omp/` | `agent/config.yml`, `keybindings.yml`, `mcp.json`, cyberdream theme, commands, loops |
-| [Skills](/ai/skills) | `dot_agents/` | `~/.agents/` | `.skill-lock.json` and every skill directory |
+| [Skills](/ai/skills) | `.chezmoidata/skills.yaml`, `.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` | `~/.agents/skills/`, `~/.claude/skills/` | Skill list and sources; installed by the Skills CLI, not vendored |
 
 ## Layout
 
@@ -39,7 +39,6 @@ The repo manages configuration for two coding agents and a skill library they sh
     - executable_cmem-to-obsidian.py
     - executable_herdr-agent-state.sh
     - gitnexus/
-  - skills/
 - dot_omp/
   - private_agent/
     - private_config.yml
@@ -50,9 +49,6 @@ The repo manages configuration for two coding agents and a skill library they sh
   - loops/
     - bin/
     - goals/
-- dot_agents/
-  - dot_skill-lock.json
-  - skills/
 
 </FileTree>