Skill review

Audit the installed inventory against canonical sources and live evidence. Resolve symlinks before editing; installed roots may expose several repositories and namespaced packs. Inspect repository status and preserve existing edits.

Inventory

List skill roots and canonical targets. Record duplicate names, broken links, missing frontmatter, trigger overlap, and large entry files. Distinguish managed sources from vendor or plugin caches. Do not treat a directory as an orphan merely because one consumer root lacks a direct link.

Read the candidate before changing it. Check commands against live help or source, runtime facts against current configuration, and behavioral rules against the user request and harness hierarchy. An old AGENTS.md is evidence to review, not proof of live topology.

Prune and repair

Keep name, provenance, invocation metadata, operational constraints, and domain-specific gotchas. Remove repeated trigger lists, stale model pins, copied command manuals, duplicated global policy, and approval gates that disregard authorization already given.

Disclose branch-specific reference material behind an explicit trigger. Preserve its links. Do not replace useful runbooks with empty pointers or update vendor caches as if they were canonical.

Use joelclaw skills ensure --help for supported install repairs. Inspect real-directory conflicts before replacing anything. Add or change install manifests in their owning repository.

Verify