claude-code-audit

Validate Claude Code customizations for naming, structure, and best practices.

13|Updated Dec 31, 2025

Search Tags:#validation #evaluation #structure #progressive disclosure #naming conventions

One-click install

npx skills add https://github.com/philoserf/claude-code-setup --skill claude-code-audit

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: claude-code-audit
Source: https://github.com/philoserf/claude-code-setup/tree/main/skills/claude-code-audit
Command: npx skills add https://github.com/philoserf/claude-code-setup --skill claude-code-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive evaluation and validation of Claude Code customizations, focusing on naming conventions, structure, and best practices across agents, commands, skills, hooks, and output-styles.

Core Features & Use Cases

Frontmatter validation: checks for required fields and naming consistency
Trigger/discovery analysis: ensures triggers are discoverable and well-described
Progressive disclosure checks: enforces lean SKILL.md with references for deeper content
Reference organization: validates references files and navigation
Tool permissions alignment: ensures appropriate allowed-tools
Documentation quality: evaluates overall documentation signal for discoverability

Quick Start

Evaluate a sample claude-code customization to identify gaps and improvements.