quality_review

Analyze Swarm trajectories, tool usage, and orchestration to detect inefficiencies.

4|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/dewitt/swarm --skill quality-review-dewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quality_review
Source: https://github.com/dewitt/swarm/tree/main/skills/quality_review
Command: npx skills add https://github.com/dewitt/swarm --skill quality-review-dewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Quality Reviewer provides a rigorous, end-to-end evaluation agent focused on analyzing Swarm's cognitive trajectories, tool-use discipline, handoff quality, and adherence to grading rubrics. It helps identify loops, inefficiencies, and orchestration gaps that hinder task success.

Core Features & Use Cases

  • Trajectory & telemetry analysis: examines how agents plan, execute, and monitor tasks, flagging cognitive dead ends and sub-optimal tool calls.
  • Skill and persona audits: reviews how sub-agents are selected and routed, and evaluates instructions within SKILL.md for clarity and bounded behavior.
  • Evaluation suite inspection: evaluates available rubrics, fixtures, and scenarios to ensure objective, measurable assessments.
  • Reporting & remediation guidance: groups findings into actionable categories and suggests experiments to improve reliability and performance.

Quick Start

Initiate a comprehensive quality review of the active Swarm session and produce actionable improvement recommendations.

Frequently Asked Questions about quality_review

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

FAQPage Schema
How do I evaluate agent orchestration and identify misrouted handoffs in Swarm workflows?

Evaluating agent orchestration involves analyzing Swarm trajectories and telemetry to detect loops, inefficiencies, and sub-optimal tool calls. This review identifies misrouted handoffs and orchestration gaps that hinder task success.

What is trajectory analysis in multi-agent systems and how does it improve workflow quality?

Trajectory analysis in multi-agent systems examines how agents plan, execute, and monitor tasks to flag cognitive dead ends. It improves workflow quality by identifying inefficient tool usage, brittle prompts, and orchestration gaps, generating actionable remediation guidance.

How do I audit SKILL.md instructions and sub-agent routing for bounded behavior?

Auditing SKILL.md instructions and sub-agent routing involves reviewing how sub-agents are selected and evaluating their instructions for clarity and bounded behavior. This skill audit detects brittle prompts and ensures proper persona adherence within the Swarm session.

Does this quality review tool require external dependencies to collect local telemetry?

No external dependencies are required to collect local telemetry. The quality review tool leverages local file access, directory listing, text search, and shell execution via built-in functions like list_local_files, read_local_file, grep_search, and bash_execute to gather data.

Can I use this to inspect evaluation rubrics and test fixtures for Swarm agents?

Yes, you can use this to inspect evaluation rubrics and test fixtures. The tool evaluates available rubrics, fixtures, and scenarios to ensure objective, measurable assessments and groups findings into actionable categories with suggested experiments.