What problem does it solve? Skills installed in one directory but missing from another cause silent failures where slash commands or skills never load. This Skill audits the layout between .agents/skills (the real source) and .claude/skills (the runtime mirror) and reports exactly which links are broken, orphaned, or pointing at the wrong target. ## Core Features & Use Cases - Layout Detection: Automatically recognizes both valid layouts—parent symlink (.claude/skills linking to .agents/skills) and per-child symlinks—without forcing a migration. - Five Issue Classifications: Detects orphan-in-claude, missing-link, not-symlink, broken-symlink, and wrong-target problems, each with evidence paths and suggested fix commands. - Scoped Audits with JSON Output: Audit project scope, global home scope, or both, with --project-root, --project-only, --global-only, and --json flags for automation. - Use Case: A skill you installed appears in .claude/skills but never loads. Run the audit to discover it is an orphan real directory with no source in .agents/skills, then review the suggested move-and-link commands before applying them. ## Quick Start Ask the AI to run the skill link audit on the current project and report any inconsistent or broken skill symlinks with suggested fixes.
