Skip to main content
command CX Codex

audit-agents-skills — Claude Code command: agent quality audit

audit-agents-skills — a command for Claude Code and Codex that audits agent, skill, and command quality in a project. Scans files, scores them against criteria (identity, prompt, validation, design), and grades production readiness.

CC-BY-SA-4.0 ★ 6,529 updated 2026-10-22

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/audit-agents-skills.md
Open on GitHub

What audit-agents-skills does

The command runs in three phases: discovers all agents, skills, and commands in .claude/ directories, scores each file against weighted criteria (agents and skills out of 32 points, commands out of 20), and outputs readiness grades. Use --fix to generate improvement suggestions; --verbose shows details for all criteria, not just failures.

For agents, it checks name and description (with usage context), whether a model is specified, tool restrictions, role definition in the prompt, output format, and edge case documentation. For skills, it validates YAML structure, enforces name format [a-z0-9-]+, checks for methodology and usage examples, and detects hardcoded paths or secrets. Commands are validated for name, description, arguments, and call examples.

The command scans project directories (.claude/agents/, .claude/skills/, .claude/commands/ and examples/ folders), classifies files by type, and outputs a report with counts and scores for each item.

What it helps with

  • audit agent quality before deploying to CI/CD
  • find duplicated functionality across agents and skills
  • verify agents don't contain hardcoded values or secrets
  • assess documentation completeness (examples, edge cases, error handling)
  • identify agents missing role definition or output format

Example prompts for the agent

  • Audit agent quality in the current project: /audit-agents-skills
  • Run audit with fix suggestions: /audit-agents-skills --fix
  • Get detailed report for all criteria: /audit-agents-skills --verbose

How to install audit-agents-skills

Manually: put the files in place

.claude/commands/audit-agents-skills.md

Call it with /audit-agents-skills. For all projects use ~/.claude/commands/

Questions about audit-agents-skills

How do I install audit-agents-skills in Claude Code?

Copy the command file to .claude/commands/: create the directory if needed and place audit-agents-skills.md inside. The command becomes available immediately in Claude Code.

What does audit-agents-skills do?

The command scans all agents, skills, and commands in your project, scores each one against criteria (name, description, prompt quality, examples, security), and outputs readiness grades. Use --fix to see what needs improvement; --verbose shows details for every check.

Which criteria does the command check?

For agents: name and description with usage context, specified model, tool restrictions, role definition, output format, edge cases, file size. For skills: valid YAML structure, name format [a-z0-9-]+, documented methodology, usage examples, no hardcoded paths or secrets. For commands: name, description, arguments, examples.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set45

The whole set →
security-audit The security-audit command for Claude Code and Codex inspects a project alongside Claude Code settings. It checks for exposed secrets, dependency flaws, injection risks, and hook issues, then returns a score and remediation plan. CX Codex +1 ★ 6,529repo stars update-infos-release The update-infos-release command for Claude Code tracks upstream releases and syncs guide, landing page, and MCP server data; version increments are optional. CX Codex +1 ★ 6,529repo stars self-assessment The self-assessment skill for Claude Code tests your knowledge across ten Claude topics, identifies your level and gaps, then builds a learning path that respects prerequisites. CX Codex +1 ★ 6,529repo stars source-command-track-mentions source-command-track-mentions scans the web for third-party citations of the Claude Code guide or author projects and syncs confirmed links into tracking files. CX Codex +1 ★ 6,529repo stars audit-repo-docs The audit-repo-docs command checks repository documentation against 30 criteria and produces a scored report with prioritized fixes. It spots gaps in README files, docs structure, and automation. CX Codex +1 ★ 6,529repo stars source-command-audit-whitepapers source-command-audit-whitepapers scores every whitepaper and recap card for version freshness, FR/EN parity and metadata quality, then lists what falls short. CX Codex +1 ★ 6,529repo stars audit-whitepapers audit-whitepapers audits version gaps, French/English parity, and frontmatter metadata across Quarto whitepapers and recap cards. CX Codex +1 ★ 6,529repo stars Claude Code Ultimate Guide Claude Code Ultimate Guide searches the Claude Code guide and machine-readable reference indexes directly from any MCP-compatible environment. CX Codex +1 ★ 6,529repo stars

Project sponsors

Companies that keep this analytics open