code-review
/code-review
Przegląda lub ulepsza kod w czterech trybach: błędy i bezpieczeństwo (domyślnie), wydajność, audyt czystego kodu i sprzątanie niechlujnych fragmentów, wybierane parametrem mode.
- Autor
- luongnv89 ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 24.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 24
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Przegląda lub ulepsza kod w czterech trybach: błędy i bezpieczeństwo (domyślnie), wydajność, audyt czystego kodu i sprzątanie niechlujnych fragmentów, wybierane parametrem mode.
Oryginalny opis (EN)
Review or improve code — one skill, four modes: bug/security review (default), performance, clean-code audit, slop cleanup. Pass mode:review|perf|clean|cleanup or infer. Don't use for writing features or generating tests (use test-coverage).
Jak działa
- Modes
- Selecting the mode
- Safety: cleanup writes code — the other three do not
- Repo Sync Before Edits (mandatory)
- Run the mode's workflow
- Environment Check
- Chaining modes
- Prerequisites
- Acceptance Criteria
- Expected Output
Podgląd SKILL.md
---
name: code-review
description: "Review or improve code — one skill, four modes: bug/security review (default), performance, clean-code audit, slop cleanup. Pass mode:review|perf|clean|cleanup or infer. Don't use for writing features or generating tests (use test-coverage)."
license: MIT
effort: high
metadata:
version: 2.2.2
author: "Luong NGUYEN <luongnv89@gmail.com>"
architecture: "router (4 modes, each a self-contained workflow in references/)"
---
# Code Review
One skill for reviewing and improving code quality. Pick a **mode** by intent (or pass an explicit
`mode:` parameter); each mode is a full, self-contained workflow in `references/`. Load only the
mode you need — this protects the agent's context budget.
## Modes
| Mode | Use when the user wants to... | Reads / writes | Output | Workflow |
|---|---|---|---|---|
| **review** (default) | find bugs, security holes, quality issues in a diff/PR | read-only | prioritized findings report | `references/review-mode.md` |
| **perf** | make code faster — bottlenecks, leaks, algorithmic waste | read-only | performance findings report | `references/perf-mode.md` |
| **clean** | audit readability/standards vs the bbv Clean Code cheat sheet | read-only | `CLEAN_CODE_AUDIT.md` | `references/clean-mode.md` |
| **cleanup** | actually refactor out AI slop, dead code, duplication, cruft | **WRITES CODE** | modified source files | `references/cleanup-mode.md` |
## Selecting the mode
1. **Explicit wins.** If the request carries `mode:review|perf|clean|cleanup` (or `--mode <name>`), use it.
2. **Otherwise infer** from the request. When one matched phrase sits inside a longer matched
phrase, only the longer one counts, so "clean code review" is a **clean** phrase only, not also
a **review** phrase. Phrases that do not overlap all count, whatever their length (step 3).
- "review", "find bugs", "security", "is this correct", "look for vulnerabilities" → **review**
- "slow", "faster", "optimize", "bottleneck", "memory leak", "performance" → **perf**
- "clean code audit" (or "clean-code audit"), "clean code review", "check this against clean code" → **clean**
(user-invoked only — a bare "readability" or "audit against standards" ask is ambiguous: use step 3)
- "remove slop", "clean up the codebase", "refactor out cruft / dead code / duplication" → **cleanup**
3. **No match, or phrases from more than one mode?** Ask which mode, naming the four options. For
example, "review and optimize" matches **review** and **perf**, so ask. Use **review** without
asking only when the request contains a review phrase and no other mode's phrase.
## Safety: cleanup writes code — the other three do not
`review`, `perf`, and `clean` are **source-read-only**: they analyze and report without touching
source files. Review and perf may write only the named report artifact their mode specifies
(`CODE_REVIEW.md` for review; perf returns its report in the response). During review/perf analysis,
they must not otherwise mutate the index, refs, stash, branch, worktree, or remote state.
`clean` retains its own report-writing and sync contract. `cleanup` **modifies files**. Therefore:
- **Never enter `cleanup` by weak inference.** Run it only when the user explicitly asks to
refactor / clean up the codebase (or passes `mode:cleanup`). A plain "review my code" must never
rewrite files — stay in a read-only mode.
- Review and perf analysis record `git rev-parse HEAD`, `git status`, and local tracking
observations without claiming remote freshness. They do not fetch, stash, pull, rebase,
checkout/switch, create or delete branches/worktrees, or apply source fixes. A separately
approved mutation workflow owns its own freshness and stash-first sync contract.
- **Confirm before the first write** in `cleanup`, and follow that mode's own gating.
## Repo Sync Before Edits (mandatory)
Applies to `clean` (writes `CLEAN_CODE_AUDIT.md`) and `cleanup` (writes source) only. `review` and
`perf` never sync (see the Safety section). Before the first write in either mode:
```bash
branch="$(git rev-parse --abbrev-ref HEAD)"
git fetch origin && git pull --rebase origin "$branch"
```
- If the working tree is dirty in `clean`, stash first, sync, then pop the stash.
- If the working tree is dirty in `cleanup`, stop and ask the user to commit or stash first.
- If `origin` is missing, or the pull or stash pop conflicts, stop and ask the user. Do not write any file.
- If the target is not a git repo, `clean` skips the sync and notes that in its report.
The full step, with recovery commands, is in `references/clean-mode.md` and `references/cleanup-mode.md`.
## Run the mode's workflow
Read the selected mode's reference file and execute its steps exactly. Supporting files each mode
uses (already colocated under this skill):
- **review** → `references/review-mode.md` — agents `agents/reviewer.md`, `agents/file-reviewer.md`, `agents/report-assembler.md`; refs `references/subagent-architecture.md`, `references/code-smells.md`
- **perf** → `references/perf-mode.md` — ref `references/language-checks.md`
- **clean** → `references/clean-mode.md` — refs `references/clean-code-checklist.md`, `references/tdd-checklist.md`, `references/html-report-guide.md`, `references/report-template.html`
- **cleanup** → `references/cleanup-mode.md` — the 8 cleaner agents in `agents/` (`deduplicator.md`, `type-consolidator.md`, `unused-code-killer.md`, `circular-dep-untangler.md`, `weak-type-strengthener.md`, `defensive-programming-remover.md`, `legacy-code-remover.md`, `slop-comment-cleaner.md`)
## Environment Check
If the Agent tool is available, modes that use subagents (**review**, **cleanup**) spawn them per
their workflow — fresh-context validation and parallel work. If it is unavailable (e.g., Claude.ai),
execute each mode's phases inline (less rigorous, but functional).
## Chaining modes
Modes compose: a common flow is **clean** (audit → `CLEAN_CODE_AUDIT.md`) then **cleanup** (apply the
refactors), or **review**/**perf** to find issues before fixing. Run one mode at a time; confirm with
the user before switching into the code-writing `cleanup` mode.
## Prerequisites
- If no target diff, PR, file set, or repository is named, ask for the scope before starting.
- If a reference or agent file listed for the selected mode is missing, stop and name the missing path.
- For `clean` or `cleanup`, follow that mode's sync, backup, dry-run, confirmation, and rollback steps
in order. If a sync or safety check fails, stop before the first write.
## Acceptance Criteria
Verify every run against the selected mode's own acceptance criteria, then assert all of these router
criteria:
- Exactly one mode was selected and its reference workflow was followed end to end.
- Read-only modes changed no source files; verify with a path-scoped `git diff` when applicable.
- Every finding cites concrete evidence and the expected output artifact or report was produced.
- Tests or validation commands required by the selected mode completed with their expected result.
- Edge cases, limitations, skipped files, and degraded subagent coverage are disclosed.
Also check that a reader can use the final response:
- **Result is findable:** the first line after `Mode:` states the result and PASS, PARTIAL, or FAIL.
- **Facts and assumptions are separate:** verified claims name the check that was run; inferences,
skipped scope, and untested behavior are labeled under `Uncertainty`.
- **Claims are traceable:** each finding points to a `file:line`, a command output, or a report section.
An intermediate step passing does not count as the whole run passing.
- **Next decision is clear:** `Decision` names the approval needed (for example, starting `cleanup`),
or says "No approval needed", and lists any remaining user action.
Agent inspection cannot confirm that a human understood the output. If no human feedback was given,
report human understanding as unconfirmed; do not count it as a failure or a pass.
## Expected Output
Every mode's final response carries these five items, in this order. Keep each item to one or two
lines; the mode's report artifact holds the detail.
```text
Mode: review
Result: PARTIAL — 1 critical, 2 major, 0 minor findings; reviewer pass incomplete for 3 files
Evidence: CODE_REVIEW.md written; reviewer agent validated 41/44 files; `git diff --stat -- src/` empty
Uncertainty: 3 generated files skipped (listed in CODE_REVIEW.md); no tests were run
Decision: No approval needed. To apply fixes, ask for a separate `cleanup` run.
```
## Step Completion Reports
After routing and after the selected workflow, emit a compact report:
```text
◆ Code Review ([mode])
Mode selection: √ pass
Workflow criteria: √ pass
Output verified: √ pass
Safety boundary: √ pass
Result: PASS | FAIL | PARTIAL
```
Use `× fail — reason` for any unmet check. Never report PASS while a selected-mode acceptance
criterion, expected output, required test, or safety guardrail is unresolved.
## Edge Cases
- Unknown `mode:` value → reject it and list the four valid modes.
- Mixed intents across modes → ask which mode to run first; never merge workflows implicitly.
- Missing target or inaccessible files → stop and request a concrete scope instead of guessing.
- Agent tool unavailable → use the selected reference's inline fallback and disclose reduced coverage.
- A read-only mode requests edits mid-run → finish the report, then require explicit approval before
starting a separate `cleanup` run.
Pliki w paczce (24)
- SKILL.md 9 KB
- agents/circular-dep-untangler.md 4 KB
- agents/deduplicator.md 4 KB
- agents/defensive-programming-remover.md 6 KB
- agents/file-reviewer.md 3 KB
- agents/legacy-code-remover.md 5 KB
- agents/report-assembler.md 4 KB
- agents/reviewer.md 5 KB
- agents/slop-comment-cleaner.md 6 KB
- agents/type-consolidator.md 4 KB
- agents/unused-code-killer.md 4 KB
- agents/weak-type-strengthener.md 5 KB
- docs/README.md 4 KB
- references/clean-code-checklist.md 11 KB
- references/clean-mode.md 12 KB
- references/cleanup-mode.md 15 KB
- references/code-smells.md 7 KB
- references/html-report-guide.md 7 KB
- references/language-checks.md 1 KB
- references/perf-mode.md 8 KB
- references/report-template.html 26 KB
- references/review-mode.md 10 KB
- references/subagent-architecture.md 5 KB
- references/tdd-checklist.md 9 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · luongnv89/skills | 100 | MIT |
| microsoft/aspire | 100 | MIT |
| kdlbs/kandev | 100 | AGPL-3.0 |
| dotnet/runtime | 100 | MIT |
| drosam/agents | 100 | MIT |
| ggml-org/llama.cpp | 100 | MIT |
| ShamelesAbyss/Nyx | 100 | Apache-2.0 |
| dzhng/jevgrep | 100 | MIT |
| iuliandita/skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki c5015b340c54 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100codebase-cleanup-refactor-clean
Refaktoryzuje kod według zasad czystego kodu i SOLID, poprawiając jakość, utrzymywalność i wydajność istniejącego projektu. - 100code-review-checklist
Zawiera listę kontrolną przeglądu kodu: poprawność, bezpieczeństwo, wydajność, jakość, testy i kod pisany przez AI. - 9007-refactor
Poprawia kod w czterech obszarach: porządek, wydajność, bezpieczeństwo i architekturę, przez skanowanie i poprawki albo zastosowanie raportu audytu. - 95review
Przegląda kod wielowymiarowo: poprawność, bezpieczeństwo, wydajność, typy, testy i standardy, przy PR lub na żądanie. - 100review
Sprawdza zmieniony kod według listy 25 punktów: struktura, obsługa błędów, bezpieczeństwo, wydajność i testy, przed commitem lub PR. - 100review-all
Prowadzi głęboki, wielodomenowy przegląd gotowości produkcyjnej, obejmujący bezpieczeństwo, niezawodność i kod, a wydajność tylko na wyraźną prośbę.