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.