Agent skill

review-spec

Review technical spec documents from completeness, feasibility, risk, and code consistency perspectives.

Stars 139
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/review-spec

SKILL.md

Review Spec

Trigger

  • Keywords: review spec, spec review, tech spec review, review-spec

When NOT to Use

  • Code review (use /codex-review-fast)
  • Document review (use /codex-review-doc)
  • Writing a new spec (use /tech-spec)

Agent Dispatch

Agent({
  description: "Review technical spec for completeness, feasibility, and risk",
  subagent_type: "tech-spec-reviewer",
  prompt: `Review the following technical spec document.
Follow the review dimensions and output format defined in this skill.`
})

Task

Document to Review

$ARGUMENTS

Review Flow

Step Focus
1 Read the technical spec
2 Research related code
3 Completeness check
4 Feasibility assessment
5 Risk review
6 Code consistency
7 Test strategy

Output

markdown
# Technical Spec Review Report

**Reviewed Document**: `$ARGUMENTS`

## Review Summary
| Dimension | Rating | Notes |
|-----------|--------|-------|
| Completeness | ⭐⭐⭐⭐☆ | |
| Feasibility | ⭐⭐⭐☆☆ | |
| Risk Assessment | ⭐⭐⭐⭐☆ | |
| Code Consistency | ⭐⭐⭐⭐⭐ | |
| Test Strategy | ⭐⭐⭐☆☆ | |

## Overall Verdict
✅ Approved / ⚠️ Needs revision / ❌ Needs redesign

## Strengths
-

## Issues & Recommendations
### 🔴 Must Fix (Blocker)
### 🟡 Suggested Changes
### 🟢 Optional Improvements

Expand your agent's capabilities with these related and highly-rated skills.

sd0xdev/sd0x-dev-flow

runbook

Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).

139 18
Explore
sd0xdev/sd0x-dev-flow

ask

Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.

139 18
Explore
sd0xdev/sd0x-dev-flow

project-brief

Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.

139 18
Explore
sd0xdev/sd0x-dev-flow

codex-test-gen

Generate unit tests for specified functions using Codex MCP

139 18
Explore
sd0xdev/sd0x-dev-flow

bug-fix

Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.

139 18
Explore
sd0xdev/sd0x-dev-flow

skill-health-check

Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.

139 18
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results