apm-review-panel

Orchestrate a specialist panel to review pull requests and produce a ship recommendation.

3.5k|319|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/microsoft/apm --skill apm-review-panel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apm-review-panel
Source: https://github.com/microsoft/apm/tree/main/.apm/skills/apm-review-panel
Command: npx skills add https://github.com/microsoft/apm --skill apm-review-panel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill orchestrates a cross-discipline advisory review of a labeled pull request in microsoft/apm. It runs a panel of five mandatory specialists plus a test-coverage specialist (active on every PR that touches src/) plus two conditional specialists (auth, doc-writer), all running in their own agent threads, and a CEO synthesizer. The orchestrator is the sole writer to the PR: ONE recommendation comment, no verdict labels, no merge gating. The panel surfaces findings, prioritizes follow-ups, and renders a ship recommendation; it is advisory—human review remains essential.

Core Features & Use Cases

  • Multi-persona expert advisory review with dedicated panelists across architectural, UX, security, growth, and testing surfaces.
  • Produces a single ship-recommendation comment and a structured per-panelist findings overview for quick scanning and deep dives.
  • Supports conditional panelists (auth, doc-writer) and a test-coverage check on PRs that touch code.

Quick Start

Trigger an advisory pass on a PR by running the apm-review-panel against the touched diff to generate a single advisory comment.

Frequently Asked Questions about apm-review-panel

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

FAQPage Schema
How do I automate cross-functional pull request reviews for architecture and security changes?

Automated cross-functional pull request reviews are handled by orchestrating a panel of specialists across architectural, UX, security, and growth surfaces to surface findings for human weighing. This multi-agent advisory approach generates a single ship recommendation comment without automated merge gating.

What is a multi-persona advisory review panel for pull requests?

A multi-persona advisory review panel is a multi-agent workflow where five mandatory specialists, conditional experts, and a CEO synthesizer run in separate threads. It produces a single prioritized recommendation comment and structured findings overview instead of a pass/fail verdict.

Does the advisory review panel automatically block or gate pull request merges?

No, the advisory review panel does not automatically block or gate pull request merges. The orchestrator outputs a single recommendation comment with no verdict labels, meaning human review and decision-making remain essential before shipping.

Can I run conditional specialists like auth and doc-writer on code pull requests?

Yes, you can run conditional specialists like auth and doc-writer on code pull requests. A test-coverage specialist also activates automatically on any PR that touches the src/ directory, alongside the fixed roster of architectural and growth panelists.

When should I use a multi-agent review panel instead of a standard single-agent review?

A multi-agent review panel should be used for non-trivial pull requests that touch architecture, UX, security, or growth surfaces. It is designed to surface findings across multiple lenses for human weighing, whereas standard reviews may miss cross-disciplinary impacts.

What's the best way to generate a single ship recommendation from multiple review agents?

The best way to generate a single ship recommendation is using a CEO synthesizer agent to consolidate inputs from parallel specialist threads. This orchestrator writes one unified advisory comment to the PR, prioritizing follow-ups and rendering a clear ship recommendation for human reviewers.