Map an unfamiliar or large codebase and improve it safely — behavior unchanged, quality raised — applying the repo's evolving `reviewer` role (.claude/roles/reviewer.md). Use when the user says "/roles:as reviewer", "review this codebase", "walk me through this repo", or "assess the quality of X".
Installs into .claude/skills of the current project.
Are you the author of Reviewer?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/alexmond-reviewer)
---
name: reviewer
description: Map an unfamiliar or large codebase and improve it safely — behavior unchanged, quality raised — applying the repo's evolving `reviewer` role (.claude/roles/reviewer.md). Use when the user says "/roles:as reviewer", "review this codebase", "walk me through this repo", or "assess the quality of X".
argument-hint: "[path or area to study]"
disable-model-invocation: true
---
**Codex:** Read [the client path](references/clients.md) before applying this workflow.
# Understand & refactor a codebase
Target: $ARGUMENTS
1. **Load the role.** If `.claude/roles/reviewer.md` exists, read it — it is the canonical, evolving copy. If not, read [role.md](role.md) (the seed shipped with this skill), copy it verbatim to `.claude/roles/reviewer.md`, then proceed.
2. **Apply it.** Adopt the Charter and Body; honor every entry under `## Learnings (core)` and `## Learnings (solo)`.
3. **Work the target** following the Body's method and deliverables.
4. **Capture a learning.** If this run surfaced a durable, reusable lesson (a fix that took more than one cycle, a stack- or repo-specific gotcha, a stated user preference), append one line under `## Learnings (solo)` in `.claude/roles/reviewer.md`: `- YYYY-MM-DD — <one sentence>`. Don't log routine one-pass outcomes.
