skill-pack-audit

Skill Pack Audit

A skill pack degrades in predictable ways: routing tables get copied, the same version fact gets restated, two descriptions start competing for the same task, and the always-on tier quietly grows. This is the review that finds those.

Adjacent, different job: maf-dev-loop/references/skill-sync.md checks whether a claim is still true. This checks whether it is in the right place, exactly once.

Invariants

Every finding below is a violation of one of these. State which one when reporting.

1. One routing table. It lives in rules/repository.mdc.md. A skill may link to a sibling for a specific reason; it may not list them all.
2. One owner per falsifiable fact. A version number, symbol name, enum spelling, or removed API belongs to the skill that owns that SDK surface. Everywhere else, cite the owner. Exactly one second copy is allowed: a row in a conformance grep table, because there the string is the search pattern.
3. Descriptions partition the task space. Two skills must not plausibly answer the same request. Where boundaries are close, say so with an explicit NOT for … — load X instead.
4. Universal rules live in the always-on tier. A rule that applies to all work must not sit inside a task-scoped skill, or it is only conditionally reachable.
5. The loaded tier stays small. SKILL.md should be roughly a third of its skill's total; the rest belongs in references/.
6. Every reference resolves.

Procedure

Run all six. Each is cheap and each catches a different class.

1. Inventory and size distribution

Get-ChildItem .cursor\skills -Recurse -Filter *.md |
  Sort-Object FullName |
  ForEach-Object { [pscustomobject]@{
      Path  = $_.FullName.Replace("$PWD\", '')
      Lines = (Get-Content $_.FullName).Count } } |
  Format-Table -AutoSize

For each skill compute SKILL.md ÷ (SKILL.md + references). Report the ratios together — the outlier is the finding, not any absolute threshold. A skill much above its peers has reference material sitting in the always-loaded tier (invariant 5).