code-quality-audit
Installation
SKILL.md
Code Quality Audit
Use this skill when the user asks to audit code quality, code smells, maintainability, correctness, security, complexity hotspots, observability, operational risk, or agentic/LLM risk without editing code.
Method
- Run
scripts/audit-start.shfrom the target repo or pass--repo <path>. - The script creates an audit branch, a Git worktree,
GOAL.md, andPROGRESS.md. - Start Codex in the audit worktree and set the active goal from
GOAL.md. - During audit mode, only
PROGRESS.mdmay be written. - Use read-only subagents only for bounded exploration in large or unfamiliar repos.
- The main thread owns synthesis, deduping, ranking, and the final
PROGRESS.mdwrite.