audit-agents

Validate skill and guide references and symlinks in agent dependencies.

34|5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/baekenough/oh-my-customcode --skill audit-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-agents
Source: https://github.com/baekenough/oh-my-customcode/tree/main/templates/.claude/skills/audit-agents
Command: npx skills add https://github.com/baekenough/oh-my-customcode --skill audit-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit agent dependencies to ensure all skill and guide references are valid and symlinks are working.

Core Features & Use Cases

  • Cross-check skill existence and valid paths in .claude/skills/
  • Validate guide references under guides/ and ensure link integrity
  • Generate a health report and offer automated fixes with --fix

Quick Start

Audit the agent set in your project to validate all skill and guide references and generate a health report.

Frequently Asked Questions about audit-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate agent skill and guide references in .claude/skills directories?

Validate agent skill and guide references by auditing dependencies to check path existence and symlink integrity, generating a comprehensive health report covering .claude/skills and guides directories.

What is agent dependency auditing and when do I need it?

Agent dependency auditing cross-checks skill and guide references to ensure valid paths and working symlinks. It's needed when managing diverse agents, skills, and guides to prevent broken reference links.

Can I automatically fix broken symlinks and invalid agent references?

Yes, use the --fix mode to automatically delegate repairs to /fix-refs. This validates path existence and linking, then applies targeted fixes to resolve broken symlinks and invalid agent references.

How do I run a bulk health check on all agent dependencies?

Run a bulk health check by executing the audit across your project's .claude/skills and guides directories. It reads agent metadata, validates all paths and symlinks, and reports results comprehensively.

What's the best way to ensure symlinks are working across multiple agents and guides?

The best way is running an end-to-end audit that validates guide references under guides/ and checks link integrity across all agents. This ensures symlinks are working and references remain valid.

Why does my agent reference validation report show broken paths after moving skill files?

Broken paths appear because skill file moves invalidate references and symlinks. Run the audit to detect these issues, then use --fix mode to delegate repairs and restore valid path links.