Peer review system that delegates phase plan validation to other AI agents.

Install

mkdir -p .claude/skills/gsd-review && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13487" && unzip -o skill.zip -d .claude/skills/gsd-review && rm skill.zip

Installs to .claude/skills/gsd-review

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Request cross-AI peer review of phase plans from external AI CLIs
65 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Invoke external AI CLIs for review
  • Translate `AskUserQuestion` to `request_user_input`
  • Translate `Task()` to `spawn_agent`
  • Collect responses from agents
  • Write `REVIEWS.md` with feedback

How it works

The skill translates GSD workflow commands to Codex tools, spawns agents for review based on specified CLIs, collects their responses, and compiles them into a `REVIEWS.md` file.

Inputs & outputs

You give it
Phase plans and optional CLI flags
You get back
Structured `REVIEWS.md` with per-reviewer feedback

When to use gsd-review

  • Peer review my plan
  • Request cross-agent feedback
  • Validate phase architecture

About this skill

<codex_skill_adapter>

A. Skill Invocation

  • This skill is invoked by mentioning $gsd-review.
  • Treat all user text after $gsd-review as {{GSD_ARGS}}.
  • If no arguments are present, treat {{GSD_ARGS}} as empty.

B. AskUserQuestion → request_user_input Mapping

GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:

Parameter mapping:

  • headerheader
  • questionquestion
  • Options formatted as "Label" — description{label: "Label", description: "description"}
  • Generate id from header: lowercase, replace spaces with underscores

Batched calls:

  • AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]

Multi-select workaround:

  • Codex has no multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.

Execute mode fallback:

  • When request_user_input is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.

C. Task() → spawn_agent Mapping

GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:

Direct mapping:

  • Task(subagent_type="X", prompt="Y")spawn_agent(agent_type="X", message="Y")
  • Task(model="...") → omit (Codex uses per-role config, not inline model selection)
  • fork_context: false by default — GSD agents load their own context via <files_to_read> blocks

Parallel fan-out:

  • Spawn multiple agents → collect agent IDs → wait(ids) for all to complete

Result parsing:

  • Look for structured markers in agent output: CHECKPOINT, PLAN COMPLETE, SUMMARY, etc.
  • close_agent(id) after collecting results from each agent </codex_skill_adapter>
<objective> Invoke external AI CLIs (Gemini, the agent, Codex, OpenCode) to independently review phase plans. Produces a structured REVIEWS.md with per-reviewer feedback that can be fed back into planning via /gsd-plan-phase --reviews.

Flow: Detect CLIs → Build review prompt → Invoke each CLI → Collect responses → Write REVIEWS.md </objective>

<execution_context> @/home/swiftiepi/Desktop/incuba/.codex/get-shit-done/workflows/review.md </execution_context>

<context> Phase number: extracted from {{GSD_ARGS}} (required)

Flags:

  • --gemini — Include Gemini CLI review
  • --claude — Include the agent CLI review (uses separate session)
  • --codex — Include Codex CLI review
  • --opencode — Include OpenCode review (uses model from user's OpenCode config)
  • --all — Include all available CLIs </context>
<process> Execute the review workflow from @/home/swiftiepi/Desktop/incuba/.codex/get-shit-done/workflows/review.md end-to-end. </process>

When not to use it

  • When the task is not about requesting cross-AI peer review of phase plans
  • When `request_user_input` is rejected in Execute mode

Limitations

  • Codex has no `multiSelect` for `AskUserQuestion` translation
  • Model selection is per-role config, not inline for `Task()` translation

How it compares

This skill automates the process of requesting and consolidating peer reviews from multiple external AI CLIs, unlike a manual review process.

Compared to similar skills

gsd-review side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-review (this skill)04moNo flagsIntermediate
multi-agent-brainstorming14moNo flagsIntermediate
flow-next-prime02moReviewIntermediate
claude-automation-recommender472moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry