review-spec

Solid

Review a specification document: launches an internal spec review and `/peer-review` in parallel and returns combined findings. Use when the user asks to "review my spec", "review this spec", "check my spec", "critique my spec", or wants spec feedback before planning.

Code & Development 314 stars 25 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
83
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Review Spec Run two AI spec reviews in parallel and return combined findings. ## Step 1: Identify the Spec Determine the spec to review using these rules in order: 1. **Spec text in conversation** — If full spec text is already in context, use it 2. **Explicit path** — If a file path was provided, read it 3. **Explicit slug** — If a slug was provided, resolve to `.turbo/specs/<slug>.md` 4. **Single file** — Glob `.turbo/specs/*.md`. If exactly one file exists, read it 5. **Most recent** — If multiple files exist, read the most recently modified 6. **Legacy fallback** — If `.turbo/specs/` does not exist but `.turbo/spec.md` exists, use it 7. **Nothing found** — If no spec exists, say so and stop If multiple files exist and the most-recent choice is non-obvious, use `AskUserQuestion` to let the user pick from the candidates. ## Step 2: Run Two Reviews in Parallel Launch two Agent tool calls in a single message so they run concurrently (`model: "opus"`, do not set `run_in_background`): ### Internal Spec Review Spawn a subagent with the full spec text and instruct it to: 1. Read project context (CLAUDE.md and any existing codebase) to understand constraints 2. Apply the spec determination criteria below 3. Return findings in the output format below ### Run `/peer-review` Skill Spawn a subagent whose prompt includes the full spec text and the following review prompt, and instructs it to invoke `/peer-review` via the Skill tool: ``` <task> Review the following specif...

Details

Author
tobihagemann
Repository
tobihagemann/turbo
Created
2 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Solid

creview-spec

Multi-agent adversarial review of a spec. Spawns red team, assumptions auditor, testability auditor, design contract checker, and UX auditor. Use after /cspec or /cmodel.

61 Updated yesterday
joshft
Code & Development Listed

review-spec

Use after implementing tasks or mid-feature to verify code matches design docs and ensure they are in sync. Detects spec deviations, missing implementations, doc inconsistencies, and outdated docs in design and implementation documentation.

145 Updated today
serpro69
AI & Automation Listed

go-spec-reviewer

Review design specification documents for Go programs before implementation begins. Use this skill when a user has a Go spec to review, wants feedback on a design doc, is about to start implementing from a spec, asks "is this spec ready?", or wants a technical review of a planned feature in a Go codebase. Applies Go philosophy — simplicity, composition, explicit errors, context propagation — plus Cobra/Viper CLI conventions where applicable.

1 Updated today
chafingdishposition355
AI & Automation Listed

review-spec

This skill should be used for SPEC.md artifact reviewer — validates spec quality against the SB spec template: required sections, non-empty overview, user story format, testable acceptance criteria, assumption completeness, and frontmatter fields

5 Updated today
alo-exp
Code & Development Solid

creview

Skeptically review a spec for unstated assumptions, untestable rules, missing edge cases, security gaps, and UX failures. Run after /cspec.

61 Updated yesterday
joshft