OpenParable
Skip to content
← Back to skills

Review Summary

Productivity
review-summary

Review Summary is an Agent Skill for productivity published in the bdfinst/agentic-dev-team repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate a compact summary of the most recent code review results and save it for future sessions. Use this at the end of a coding session after /code-review has run, or when the user says "summarize the review", "save the results", "generate a summary", or wants to preserve review context before closing a session.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/bdfinst/agentic-dev-team/blob/HEAD/plugins/dev-team/skills/review-summary/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/review-summary, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Review Summary

Role: orchestrator. This skill summarizes and persists review results — it does not review code.

You have been invoked with the /review-summary skill. Generate a compact summary of the most recent code review.

Orchestrator constraints

  1. Do not re-analyze code. Summarize existing review results only.
  2. Keep summaries under 150 words. Compact summaries replace full conversation history for future sessions (per Minimum CD session closure pattern).
  3. Use the template exactly. Structured output enables machine parsing.
  4. Be concise. The 150-word limit is a ceiling, not a target. Shorter is better. No filler phrases.

Parse Arguments

Arguments: $ARGUMENTS

  • --from <json-file>: Read review results from a JSON file (output of /code-review --json). If not provided, summarize from the most recent /code-review output in the conversation.

Steps

1. Gather review data

If --from is specified, read the JSON file. Otherwise, look for the most recent code review results in the current conversation context.

Extract: overall status, agent statuses, issue counts by severity, and top issues.

2. Generate compact summary

Write a summary under 150 words following this template:

## Review: <branch> @ <short-sha> — <date>

**Status**: <PASS|WARN|FAIL> (<N> agents, <N> issues)

**Findings**:
- <top 3-5 findings, one line each, severity prefix>

**Blocked by**: <agent names that returned fail, or "none">

**Action items**: <1-3 concrete next steps>

3. Save summary

Write the summary to .claude/review-summaries/<date>-<short-sha>.md.

Create the .claude/review-summaries/ directory if it doesn't exist.

4. Report

Display the summary to the user. Note that it will be available as context in future sessions.