# Audit

Project health audit and health check, architecture, performance, tests, dependencies...

- Repository: https://github.com/oliver-kriska/claude-elixir-phoenix (572 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add oliver-kriska/claude-elixir-phoenix --skill audit -g -a claude-code -y`
Codex: `npx skills add oliver-kriska/claude-elixir-phoenix --skill audit -g -a codex -y`
Cursor: `npx skills add oliver-kriska/claude-elixir-phoenix --skill audit -g -a cursor -y`
Gemini CLI: `npx skills add oliver-kriska/claude-elixir-phoenix --skill audit -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add oliver-kriska/claude-elixir-phoenix`

## Description

Project health audit and health check, architecture, performance, tests, dependencies, code quality. Use when assessing overall project health, before releases, or after refactors.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Project Health Audit

Comprehensive project-wide health assessment using 5 parallel specialist subagents.

## Usage

```
/phx:audit              # Full audit (default)
/phx:audit --quick      # 2-3 minute pulse check
/phx:audit --focus=security   # Deep dive single area
/phx:audit --focus=performance
/phx:audit --since abc123   # Incremental audit since commit
/phx:audit --since HEAD~10  # Audit last 10 commits
```

## When to Use

- **Quarterly** health checks
- **Before major releases**
- **After large refactors**
- **New team member onboarding** (understand codebase health)

## Iron Laws

1. **Wait for ALL agents before synthesizing**, Partial results create misleading health scores because cross-category correlations get missed
2. **Scope agent prompts to specific directories**, Vague prompts like "analyze the codebase" produce generic findings that waste tokens and miss real issues
3. **Never compare scores across projects**, Scoring methodology depends on project size and maturity; only track trends within the same project
4. **Quick mode before full mode**, Run `--quick` first to catch compile/test failures before spending tokens on 5 parallel agents

## Subagent Architecture

Spawn 5 specialists in parallel using Agent tool. Three route to plugin
specialists with a declared model; the two categories without a specialist use
`general-purpose` pinned to `model: "sonnet"`, unpinned, they inherit the
session model (Opus by default):

The rest: https://github.com/oliver-kriska/claude-elixir-phoenix/blob/HEAD/plugins/elixir-phoenix/skills/audit/SKILL.md