omcustom:audit-agents

Audit agent dependencies and validate skill and guide references.

13|6|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/baekenough/second-brain --skill omcustom-audit-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omcustom:audit-agents
Source: https://github.com/baekenough/second-brain/tree/main/.claude/skills/audit-agents
Command: npx skills add https://github.com/baekenough/second-brain --skill omcustom-audit-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps maintain the integrity of a Claude-like agent ecosystem by validating that all skill references and guide links are present and correctly linked, preventing broken configurations.

Core Features & Use Cases

  • Validate skill references: verify that each referenced skill path exists under .claude/skills and that paths are valid.
  • Verify guide references: ensure templates/guides exist and any symlinks are valid.
  • Report and fix issues: generate a health summary and, with the --fix option, update broken links via /fix-refs to restore consistency.

Quick Start

Run the audit to verify all agent skills and guide references, then apply fixes with the --fix option if issues are found.

Frequently Asked Questions about omcustom:audit-agents

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

FAQPage Schema
How do I audit agent dependencies and verify skill references?

To audit agent dependencies, scan the .claude/agents and templates directories to validate that all referenced skill paths and guide symlinks exist and are correctly linked. This generates a health summary reporting broken configurations.

Why do my agent templates have broken symlinks and guide references?

Broken symlinks and guide references occur when cross-references drift in environments with multiple agents and templates. Validating the existence of .claude/skills and templates/guides identifies these broken links.

Can I automatically fix broken skill references and symlinks?

Yes, you can automatically fix broken skill references and symlinks by running the audit with the --fix option. This triggers the /fix-refs command to update broken links and restore ecosystem consistency.

What is the best way to maintain governance over a large agent inventory?

Maintaining governance over a large agent inventory requires regularly scanning .claude/agents to validate skill paths and ensure symlinks are functioning. This prevents configuration drift across multiple agents and templates.

Does this skill audit work with nested .claude/skills directories?

The audit works by verifying that each referenced skill path exists under the .claude/skills directory. It validates path existence and symlink integrity to ensure all nested references are correctly linked.