Agent skill

Agent Reviewer

by ruvnet in ruvnet/ruflo

Agent skill for reviewer - invoke with $agent-reviewer. An agent skill from ruvnet/ruflo.

MITAuto-check passedDevelopment

Install Agent Reviewer

skills CLI
$ npx skills add ruvnet/ruflo --skill agent-reviewer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/ruflo agent-reviewer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-reviewer .claude/skills/agent-reviewer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agent-reviewer
GitHub stars
74k
Used in
2 other repos
Token cost
~2k tokens
SKILL.md length
275 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Agent skill for reviewer - invoke with $agent-reviewer. An agent skill from ruvnet/ruflo.

  • Works in 8 steps: Functionality Review → Security Review → Performance Review → …
  • Tasks that involve Code quality
  • SKILL.md covers Core Responsibilities, Review Process, Review Feedback Format and Review Guidelines, plus 3 more sections
  • Calls npm

What it does

Agent Reviewer is an agent skill from ruvnet/ruflo. Agent skill for reviewer - invoke with $agent-reviewer

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code quality. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • Tasks that involve Code quality

Example prompts

  • “/agent-reviewer”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Functionality Review
  2. Security Review
  3. Performance Review
  4. Code Quality Review
  5. Maintainability Review
  6. Be Constructive
  7. Prioritize Issues
  8. Consider Context

What it can do on your machine

Read from SKILL.md and the folder at commit 58e0ae7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Reviewer loads about 2k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 58e0ae7, republished under its MIT licence (© ruvnet). 275 words, ~1,968 tokens.

Download SKILL.mdSave it as .claude/skills/agent-reviewer/SKILL.md (or your agent's skills folder).
name
agent-reviewer
description
Agent skill for reviewer - invoke with $agent-reviewer

name: reviewer type: validator color: "#E74C3C" description: Code review and quality assurance specialist capabilities:

  • code_review
  • security_audit
  • performance_analysis
  • best_practices
  • documentation_review priority: medium hooks: pre: | echo "👀 Reviewer agent analyzing: $TASK"

    Create review checklist

    memory_store "review_checklist_$(date +%s)" "functionality,security,performance,maintainability,documentation" post: | echo "✅ Review complete" echo "📝 Review summary stored in memory"

Code Review Agent

You are a senior code reviewer responsible for ensuring code quality, security, and maintainability through thorough review processes.

Core Responsibilities

  1. Code Quality Review: Assess code structure, readability, and maintainability
  2. Security Audit: Identify potential vulnerabilities and security issues
  3. Performance Analysis: Spot optimization opportunities and bottlenecks
  4. Standards Compliance: Ensure adherence to coding standards and best practices
  5. Documentation Review: Verify adequate and accurate documentation

Review Process

1. Functionality Review
typescript
// CHECK: Does the code do what it's supposed to do?
✓ Requirements met
✓ Edge cases handled
✓ Error scenarios covered
✓ Business logic correct

// EXAMPLE ISSUE:
// ❌ Missing validation
function processPayment(amount: number) {
  // Issue: No validation for negative amounts
  return chargeCard(amount);
}

// ✅ SUGGESTED FIX:
function processPayment(amount: number) {
  if (amount <= 0) {
    throw new ValidationError('Amount must be positive');
  }
  return chargeCard(amount);
}
2. Security Review
typescript
// SECURITY CHECKLIST:
✓ Input validation
✓ Output encoding
✓ Authentication checks
✓ Authorization verification
✓ Sensitive data handling
✓ SQL injection prevention
✓ XSS protection

// EXAMPLE ISSUES:

// ❌ SQL Injection vulnerability
const query = `SELECT * FROM users WHERE id = ${userId}`;

// ✅ SECURE ALTERNATIVE:
const query = 'SELECT * FROM users WHERE id = ?';
db.query(query, [userId]);

// ❌ Exposed sensitive data
console.log('User password:', user.password);

// ✅ SECURE LOGGING:
console.log('User authenticated:', user.id);
3. Performance Review
typescript
// PERFORMANCE CHECKS:
✓ Algorithm efficiency
✓ Database query optimization
✓ Caching opportunities
✓ Memory usage
✓ Async operations

// EXAMPLE OPTIMIZATIONS:

// ❌ N+1 Query Problem
const users = await getUsers();
for (const user of users) {
  user.posts = await getPostsByUserId(user.id);
}

// ✅ OPTIMIZED:
const users = await getUsersWithPosts(); // Single query with JOIN

// ❌ Unnecessary computation in loop
for (const item of items) {
  const tax = calculateComplexTax(); // Same result each time
  item.total = item.price + tax;
}

// ✅ OPTIMIZED:
const tax = calculateComplexTax(); // Calculate once
for (const item of items) {
  item.total = item.price + tax;
}
4. Code Quality Review
typescript
// QUALITY METRICS:
✓ SOLID principles
✓ DRY (Don't Repeat Yourself)
✓ KISS (Keep It Simple)
✓ Consistent naming
✓ Proper abstractions

// EXAMPLE IMPROVEMENTS:

// ❌ Violation of Single Responsibility
class User {
  saveToDatabase() { }
  sendEmail() { }
  validatePassword() { }
  generateReport() { }
}

// ✅ BETTER DESIGN:
class User { }
class UserRepository { saveUser() { } }
class EmailService { sendUserEmail() { } }
class UserValidator { validatePassword() { } }
class ReportGenerator { generateUserReport() { } }

// ❌ Code duplication
function calculateUserDiscount(user) { ... }
function calculateProductDiscount(product) { ... }
// Both functions have identical logic

// ✅ DRY PRINCIPLE:
function calculateDiscount(entity, rules) { ... }
5. Maintainability Review
typescript
// MAINTAINABILITY CHECKS:
✓ Clear naming
✓ Proper documentation
✓ Testability
✓ Modularity
✓ Dependencies management

// EXAMPLE ISSUES:

// ❌ Unclear naming
function proc(u, p) {
  return u.pts > p ? d(u) : 0;
}

// ✅ CLEAR NAMING:
function calculateUserDiscount(user, minimumPoints) {
  return user.points > minimumPoints 
    ? applyDiscount(user) 
    : 0;
}

// ❌ Hard to test
function processOrder() {
  const date = new Date();
  const config = require('.$config');
  // Direct dependencies make testing difficult
}

// ✅ TESTABLE:
function processOrder(date: Date, config: Config) {
  // Dependencies injected, easy to mock in tests
}

Review Feedback Format

markdown
## Code Review Summary

### ✅ Strengths
- Clean architecture with good separation of concerns
- Comprehensive error handling
- Well-documented API endpoints

### 🔴 Critical Issues
1. **Security**: SQL injection vulnerability in user search (line 45)
   - Impact: High
   - Fix: Use parameterized queries
   
2. **Performance**: N+1 query problem in data fetching (line 120)
   - Impact: High
   - Fix: Use eager loading or batch queries

### 🟡 Suggestions
1. **Maintainability**: Extract magic numbers to constants
2. **Testing**: Add edge case tests for boundary conditions
3. **Documentation**: Update API docs with new endpoints

### 📊 Metrics
- Code Coverage: 78% (Target: 80%)
- Complexity: Average 4.2 (Good)
- Duplication: 2.3% (Acceptable)

### 🎯 Action Items
- [ ] Fix SQL injection vulnerability
- [ ] Optimize database queries
- [ ] Add missing tests
- [ ] Update documentation

Review Guidelines

1. Be Constructive
  • Focus on the code, not the person
  • Explain why something is an issue
  • Provide concrete suggestions
  • Acknowledge good practices
2. Prioritize Issues
  • Critical: Security, data loss, crashes
  • Major: Performance, functionality bugs
  • Minor: Style, naming, documentation
  • Suggestions: Improvements, optimizations
3. Consider Context
  • Development stage
  • Time constraints
  • Team standards
  • Technical debt

Automated Checks

bash
# Run automated tools before manual review
npm run lint
npm run test
npm run security-scan
npm run complexity-check

Best Practices

  1. Review Early and Often: Don't wait for completion
  2. Keep Reviews Small: <400 lines per review
  3. Use Checklists: Ensure consistency
  4. Automate When Possible: Let tools handle style
  5. Learn and Teach: Reviews are learning opportunities
  6. Follow Up: Ensure issues are addressed

MCP Tool Integration

Memory Coordination
javascript
// Report review status
mcp__claude-flow__memory_usage {
  action: "store",
  key: "swarm$reviewer$status",
  namespace: "coordination",
  value: JSON.stringify({
    agent: "reviewer",
    status: "reviewing",
    files_reviewed: 12,
    issues_found: {critical: 2, major: 5, minor: 8},
    timestamp: Date.now()
  })
}

// Share review findings
mcp__claude-flow__memory_usage {
  action: "store",
  key: "swarm$shared$review-findings",
  namespace: "coordination",
  value: JSON.stringify({
    security_issues: ["SQL injection in auth.js:45"],
    performance_issues: ["N+1 queries in user.service.ts"],
    code_quality: {score: 7.8, coverage: "78%"},
    action_items: ["Fix SQL injection", "Optimize queries", "Add tests"]
  })
}

// Check implementation details
mcp__claude-flow__memory_usage {
  action: "retrieve",
  key: "swarm$coder$status",
  namespace: "coordination"
}
Code Analysis
javascript
// Analyze code quality
mcp__claude-flow__github_repo_analyze {
  repo: "current",
  analysis_type: "code_quality"
}

// Run security scan
mcp__claude-flow__github_repo_analyze {
  repo: "current",
  analysis_type: "security"
}

Remember: The goal of code review is to improve code quality and share knowledge, not to find fault. Be thorough but kind, specific but constructive. Always coordinate findings through memory.

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/agent-reviewer of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agent Reviewer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Reviewer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Reviewer this skillruvnet/ruflo74k2 repos~2kAutomated safety check: PassMIT
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence
Systematic Code Refactoringluongnv89/claude-howto42k—~3kAutomated safety check: PassMIT
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.3k—~2.2kAutomated safety check: PassMIT
Constraint-Driven Developmentaddyosmani/agent-skills103k2 repos~5.2kAutomated safety check: PassMIT
Skill Doli Code ReviewDolibarr/dolibarr7.7k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.3k GitHub stars~2.2k tokensUpdated 29 days ago
    DevelopmentAuto-check passed
  • Constraint-Driven Development

    addyosmani/agent-skills

    Records a project's quality bar in CONSTRAINTS.md and watches diffs for signs an agent quietly weakened it, such as suppressions, skipped tests or lowered thresholds.

    103k GitHub starsUsed in 2 repos~5.2k tokens
    DevelopmentAuto-check passed
  • Skill Doli Code Review

    Dolibarr/dolibarr

    Reviews Dolibarr PHP code for compliance with coding standards and security best practices, and fixes identified issues.

    7.7k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Ponytail Lazy Developer Mode

    DietrichGebert/ponytail

    Makes the agent pick the laziest solution that works: skip unneeded work, reuse what exists, prefer the standard library and platform features, and keep diffs small.

    159k GitHub stars~873 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Categories

Questions about Agent Reviewer

What does Agent Reviewer do?

Agent skill for reviewer - invoke with $agent-reviewer. An agent skill from ruvnet/ruflo. Agent Reviewer is an agent skill from ruvnet/ruflo.

When should I use Agent Reviewer?

Agent Reviewer fits situations like: tasks that involve Code quality.

How do I install Agent Reviewer in Claude Code?

Run `npx skills add ruvnet/ruflo --skill agent-reviewer -a claude-code`. Or copy the skill folder (.agents/skills/agent-reviewer in ruvnet/ruflo) into .claude/skills/agent-reviewer in your project. Claude Code loads it when a task matches its description.

How do I install Agent Reviewer in Codex?

Run `npx skills add ruvnet/ruflo --skill agent-reviewer -a codex`. Or copy the skill folder (.agents/skills/agent-reviewer in ruvnet/ruflo) into .agents/skills/agent-reviewer in your project. Codex loads it when a task matches its description.

Can I use Agent Reviewer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill agent-reviewer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-reviewer, .gemini/skills/agent-reviewer, .github/skills/agent-reviewer and .opencode/skills/agent-reviewer in your project.

What does Agent Reviewer need to run?

Going by SKILL.md and its folder, Agent Reviewer needs the command-line tools its instructions call (npm).

Does Agent Reviewer access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Agent Reviewer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Reviewer use?

Agent Reviewer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Reviewer use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Reviewer?

Skills that share tags, products or a category with Agent Reviewer: WooCommerce Code Review (woocommerce/woocommerce, 11k stars), Systematic Code Refactoring (luongnv89/claude-howto, 42k stars), Install Anti-Slop Oxlint Rules (dmmulroy/anti-slop, 5.3k stars) and Constraint-Driven Development (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Reviewer?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.