phx-audit
Project health audit and health check — architecture, performance, tests, dependencies, code quality. Use when assessing overall project health, before releases, or after refactors.
npx skills add oliver-kriska/claude-elixir-phoenix --skill phx-audit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Project Health Audit Comprehensive project-wide health assessment across five independent concern tracks. ## 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. **Complete every selected track before synthesizing** — partial results make cross-category scores misleading 2. **Scope each track to concrete directories and checks** — vague project-wide analysis produces generic findings 3. **Never compare scores across projects** — track trends only within the same codebase 4. **Run quick mode before full mode** — catch basic failures before expensive analysis ## Portable Audit Workflow 1. Create `.claude/audit/reports/` and `.claude/audit/summaries/`. 2. Run the quick checks below. Stop and report a blocker when the project cannot compile or its test command cannot start. 3. Complete
- Usage
- When to Use
- Iron Laws
- Portable Audit Workflow
- Output Format
- Quick Mode (--quick)
- Focus Mode (--focus=area)
- Incremental Mode (--since <commit>)
- Relationship to Other Commands
- References
What does the phx-audit skill do?
Project health audit and health check — architecture, performance, tests, dependencies, code quality. Use when assessing overall project health, before releases, or after refactors.
How do I install it?
Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill phx-audit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From oliver-kriska/claude-elixir-phoenix, a repository with 515 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.