skills.rest
compozy
compozyOFFICIAL
Explore all skills by this author →
Website𝕏@compozyaiGitHub

cy-spec-peer-review

Runs an Opus peer review on approved AGH TechSpecs via compozy exec.

182|8|Updated Apr 4, 2026
Search Tags:#validation#autonomy#architecture review#techspec#llm peer review#agh-network#markdown findings
One-click install
npx skills add https://github.com/compozy/agh --skill cy-spec-peer-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cy-spec-peer-review
Source: https://github.com/compozy/agh/tree/main/.agents/skills/cy-spec-peer-review
Command: npx skills add https://github.com/compozy/agh --skill cy-spec-peer-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill helps you run an optional, explicit cross-LLM peer review of an AGH TechSpec that you have already approved, so you can catch autonomy/network/memory-impacting issues before final commitment.

Core Features & Use Cases

  • Explicit, opt-in peer review rounds: runs only when the user explicitly requests a review after approval, and it will not auto-loop.
  • Contracted findings artifact: produces a single authoritative, structured Markdown findings file under .compozy/tasks/<slug>/qa/ for user-directed incorporation.
  • Quality-marker gate + validated output: checks the TechSpec has all six required quality markers before invoking the reviewer, and then validates the findings structure via the bundled validator.

Quick Start

Ask for a peer review round for the approved TechSpec by invoking the skill with the techspec path (for example: specify the _techspec.md file you want reviewed).

Frequently Asked Questions about cy-spec-peer-review

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

FAQPage Schema
How do I run a peer review on an approved TechSpec?▼

To run a peer review on an approved TechSpec, invoke the skill with the path to your _techspec.md file. The skill uses an Opus reviewer to pressure-test the spec for autonomy, network, and memory impacts.

What are the prerequisites for validating a TechSpec draft?▼

TechSpec validation requires your draft to have all six required quality markers present. The skill runs strict prechecks to gate the review process, ensuring only properly structured drafts undergo the Opus peer review.

Does the LLM peer review automatically incorporate findings into my TechSpec?▼

No, the LLM peer review does not auto-commit or auto-incorporate findings. It produces a structured Markdown findings artifact for user-directed incorporation, leaving you in full control of applying the suggested changes.

When should I use an explicit post-approval review round for my architecture spec?▼

Use an explicit post-approval review round when your TechSpec impacts autonomy, network, or memory systems. This opt-in process is designed to catch critical issues in approved drafts before final commitment.

What format does the TechSpec review output use?▼

The TechSpec review outputs a single authoritative, structured Markdown findings file. This artifact is placed under the .compozy/tasks/<slug>/qa/ directory and its structure is validated by a bundled validator.

Related Skills

Explore More Software Engineering Skills→
MatheusBBarniMatheusBBarni
1

cy-create-techspec

Convert PRD requirements into a technical specification with ADRs.

Community
Advanced
compozycompozy
182

cy-codex-loop

Drive deterministic Compozy techspec execution with resumable iterations and atomic git checkpoints.

Official
Advanced
ViniciuscarvalhoViniciuscarvalho
11

techspec-validator

Validate PRD-to-TechSpec coverage and generate a techspec-validation.md report.

Community
Advanced
Obsidian-OwlObsidian-Owl
9

gate-wiring

Detect unused exports, orphaned files, layer violations, and circular dependencies in changed code.

Official
Intermediate