agentleFS
osama-2000236osama-2000236/agent-orchestra/review-agent/SKILL.md

review-agent

Skill1 starsChanged 34 days agoMITView on GitHub

Perform a defect-first review of code changes or an entire application with explicit evidence and quality coverage. Default to read-only independent review; coordinate subagents or implement fixes only when the user explicitly requests those modes.

12 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use review.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • SentrySkill

    review

    Fixture review skill.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep this mode read-only unless fixes are requested.

    line 22
  2. Very specific:

    Read the orchestration workflow.

    line 26
  3. Distinctive:

    Follow the user's designated design model.

    line 28

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Review Agent

Select the requested mode, not the broadest possible mode. Read applicable repository rules and preserve the user's authorization and exclusions.

Independent change review (default)

Inspect the target directly. Do not modify files, commit, push, post comments or delegate this independent opinion unless the request explicitly authorizes a coordinating role. A reviewer asked by another agent to inspect a diff remains a read-only non-author reviewer.

Inspect the complete diff and enough callers, tests and supported data shapes to demonstrate every actionable regression. Continue through the whole target after the first finding. For a base-branch review, resolve the local comparison branch/upstream, prefer its upstream when ahead, compute git merge-base HEAD <comparison-ref>, then inspect the change that would actually merge. Try a configured upstream before declaring a local ref unavailable.

Flag a change-review issue only when it is introduced by this diff, discrete and meaningful, demonstrated from a real scenario/call path, and likely worth fixing. Include correctness, security/permissions, reliability, compatibility, performance and maintainability; inspect design/accessibility when the diff changes the interface and real artifacts are available. Do not invent defects, reopen unrelated old paths or turn taste into a regression.

Entire-application review

When explicitly asked to review the whole app, map its actual sections across the quality dimensions. The scope includes existing actionable defects, not only a recent diff. Mark source inspection, executed checks, unavailable evidence and remaining uncertainty separately. Cross-section joins and old data need concrete attention. No wording-only or source-only pass proves the rendered interface or real hardware behavior.

Keep this mode read-only unless fixes are requested. If the user requests fixes, coordinate the defect-first implementation, verification and authorized finish described below; preserve an independent non-author review before release.

Coordinating or fixing, when explicitly requested

Read the orchestration workflow. It covers available native/CLI agents, exact model/effort/cost controls, scoped section workers, bounded learning and required project gates. Read dispatch only for the runtime used and evidence controls when choosing or recording model/effort/cost options.

Follow the user's designated design model. Do not silently substitute it on quota failure; preserve its partial artifacts and continue independent sections. The presence of this skill never supplies missing authorization for agent spawning, secret access, deployment or external messages.

Return evidence and judgment

Findings first, ordered by severity, one issue each:

[P1] Imperative finding title — path/to/file:line

Explain the concrete scenario, consequence and evidence in a short paragraph. Cite a minimal relevant location overlapping the diff for change review; whole-app findings cite the current responsible path. P0 is a universal/critical release blocker, P1 urgent, P2 ordinary, P3 low impact but actionable. “No findings.” is valid.

Finish with the actual candidate, checks run, material gaps/risks and a brief evidence-based judgment. A non-author read-only reviewer returns that judgment for the lead to record; it does not write a ledger or mutate the skill. In an authorized coordinating mode, record checked outcomes locally and promote only independently evaluated improvements. No proof of exhaustive correctness or cheapest/best model quality is implied.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.