skills-organizelisted

# skills-organize — catalog, health, and repo layout for Agent Skills Part of the **skills-ops** module. Two modes over one engine (`scripts/Get-SkillInventory.ps1`). Never touches the plugin cache or `~/.claude/skills` — only the project skills inside the target repo. See `references/layout.md` for the canonical layout and the lint rules. ## Mode 1 — Report (read-only, the default) Answers "what skills do I have and are they healthy?". Run the engine and summarize. ```powershell $inv = & "${CLAUDE_PLUGIN_ROOT}/scripts/Get-SkillInventory.ps1" -Root . -Scope all ``` Present, grouped by scope (plugin / personal / project): - **Catalog** — name, namespace, project, one-line description. - **Health flags** (the description is the routing surface, so lint it): - `lint.thirdPerson` false → rewrite from first person ("I can…") to third person. - `lint.hasTriggers` false → add concrete trigger terms / "Use when…". - `lint.hasWhenNotToUse` false → add a "when NOT to use → see X" clause (the #1 lever against mis-triggering between neighbors). - `budget.overCap` true → description over the 1536-char cap; it gets truncated (a silently weakened skill). - **near-duplicates** — the `overlaps` array (description keyword Jaccard ≥ 0.5). Each pair needs a disambiguation edit or a merge. - **misplaced / orphaned** — `misplaced=true` means a SKILL.md outside `.claude/skills` (or `plugins/*/skills`); candidates for Mode 2. > The `budget` block is a **proxy** for Claude Code's `doct