feat: update docs for token efficient usage

.claude/skills/CLAUDE.md

@@ -0,0 +1,13 @@
+# skills/
+
+## Subdirectories
+
+| Directory | What | When to read |
+| --------- | ---- | ------------ |
+| `planner/` | Planning workflow with resource sync | Complex features (3+ files) |
+| `problem-analysis/` | Structured problem decomposition | Uncertain approach, debugging |
+| `decision-critic/` | Decision stress-testing | Architectural choices, tradeoffs |
+| `codebase-analysis/` | Systematic codebase investigation | Unfamiliar areas, audits |
+| `doc-sync/` | CLAUDE.md/README.md synchronization | After refactors, periodic audits |
+| `incoherence/` | Detect doc/code drift | Documentation inconsistencies |
+| `prompt-engineer/` | Prompt optimization techniques | Improving AI prompts |

.claude/skills/doc-sync/CLAUDE.md

@@ -0,0 +1,14 @@
+# skills/doc-sync/
+
+## Files
+
+| File | What | When to read |
+| ---- | ---- | ------------ |
+| `README.md` | Skill overview and usage examples | Understanding when to use doc-sync |
+| `SKILL.md` | Complete skill workflow definition | Executing the doc-sync skill |
+
+## Subdirectories
+
+| Directory | What | When to read |
+| --------- | ---- | ------------ |
+| `references/` | Trigger pattern examples | Writing good CLAUDE.md triggers |