# audit-agents-skills

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/audit-agents-skills.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/audit-agents-skills

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/audit-agents-skills.md` — Call it with /audit-agents-skills. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/audit-agents-skills.md` — Call it with /prompts:audit-agents-skills. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/audit-agents-skills.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/audit-agents-skills.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/audit-agents-skills.md

## When to use it
- 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
- 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`

## Similar
- [deep-app-audit](https://affpapa.org/en/nevibecode/skills/deep-app-audit.md) — skill · 458 installs
- [audit-slash-command](https://affpapa.org/en/nevibecode/commands/audit-slash-command.md) — command · ★ 1988 repo stars
- [audit-project](https://affpapa.org/en/nevibecode/plugins/audit-project.md) — plugin · ★ 2003 repo stars
- [production-code-audit](https://affpapa.org/en/nevibecode/skills/sickn33-production-code-audit.md) — skill · 1300 installs
- [skill-judge](https://affpapa.org/en/nevibecode/plugins/skill-judge.md) — plugin · ★ 2707 repo stars
- [grade-system](https://affpapa.org/en/nevibecode/skills/grade-system.md) — skill · 657 installs

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
