review-agent

Reviews agent definitions against conventions and returns a severity-ranked verdict.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill review-agent-sagittaras
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-agent
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/review-agent
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill review-agent-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It provides an independent, clean-context review of a finished or modified agent definition, checking both convention compliance and system prompt quality before the agent goes live, without ever editing the agent itself. ## Core Features & Use Cases - Convention compliance check: Validates naming rules, the mandatory frontmatter five-tuple, the model × effort × maxTurns matrix, and justification comments for omitted fields. - System prompt quality audit: Detects blocking issues such as instructions to ask the user, tools mismatched with the mandate, references to project documents or .claude/rules, and unanchored paths. - Structured verdict output: Returns an approved/rework verdict with findings classified as blocking, recommendation, or note, including verification of unresolved findings from previous review rounds. - Use Case: After write-agent finishes a round of edits on a new agent, it spawns this reviewer as a subagent to independently confirm the agent meets conventions before approval. ## Quick Start Ask the assistant to review the agent at a given path against the plugin conventions and return the verdict with findings.

Frequently Asked Questions about review-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an agent definition against conventions?▼

Invoke the review with the plugin root path, target repository path, and paths to the agents under review. The reviewer reads the convention files, checks each criterion, and returns a verdict with findings ranked by severity.

What does the agent review check in the frontmatter?▼

It verifies the mandatory five fields (name, description, model, effort, tools), the model-effort-maxTurns matrix fit, kebab-case naming without colons, and justification comments for every omitted optional field.

Can the reviewer fix the agent issues it finds?▼

No. The reviewer is strictly read-only and never edits the reviewed agent. Every finding includes a concrete fix recommendation, but corrections are left to the authoring skill to preserve review independence.

What counts as a blocking finding in agent review?▼

Blocking findings include instructions to ask the user, tools mismatched with the agent's mandate, missing negative scoping in the description, references to project documents or .claude/rules, and broken path anchoring.

When should I not use this review skill?▼

Do not use it to write or repair agents, review skills, rules, ADRs, or general code. It only assesses agent definitions; other artifact types have their own dedicated review skills.