- Home
- Skills
- Technical Documentation
- Spec Review
Spec Review
`/spec-review` turns the file into a review page where you go section by section and mark each one **OK** or **Change**, with a comment.
Free
Works with the AI Agents you already use
Spec Review
Example session with this skill installed
/spec-review docs/specs/checkout-redesign.md --lang en
- Read your context and instructions
- Compiled the spec review
Review page ready: docs/specs/checkout-redesign.review.html, also published as a private Artifact: https://claude.ai/code/artifact/…
| Sections | 9 |
| Key decisions | 4 |
| Flow diagrams | 2 |
| Notes model | Sonnet (cached in checkout-redesign.review.json) |
What's on the page
- Each of the 9 sections has a one-line summary and
OK / Change buttons with a comment box. A progress rail shows how many you have reviewed.
Key decisions lists the 4 choices the spec makes, each with its "why" and a link to the source lines (e.g. "Guest checkout stays, because 38% of orders come from guests", lines 42-47).
- Flows: the payment retry flow and the address validation flow are drawn as diagrams.
Next steps
- Open the link and go through the sections.
- Press Send to Claude. Your review arrives here as a comment.
- I apply each requested change to
checkout-redesign.md, republish the page and reply in the thread with what changed.
Not in claude.ai? Use Copy feedback and paste it here instead.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
Reviewing a long spec or plan in a terminal or a raw .md is slow. /spec-review turns the file into a review page where you go section by section and mark each one OK or Change, with a comment.
- Per-section OK / Change with comments, plus a progress rail
- Copy feedback button that collects every comment, ready to paste back to your agent
- AI notes: a one-line summary per section, key decisions with their "why", and a flow diagram where one helps. Every note must cite real lines of the source, or the script drops it
- Send to Claude (artifact mode): when Claude Code is signed in to claude.ai, the page is published as a private Artifact. Your review arrives in the session as a comment, Claude applies it to the
.md, republishes the page and answers in the thread
Why it is cheap
Node scripts (no dependencies) write all the HTML. The AI only writes a small JSON of notes per document (Sonnet by default, Haiku with --fast, about 1/20 of the cost). The notes are cached while the .md does not change, so re-rendering costs 0 tokens.
Usage
/spec-review docs/specs/my-feature.md
/spec-review docs/plans/my-plan.md --fast
Flags: --fast (Haiku notes), --no-ai (plain page), --lang en (English labels, default Spanish), --html (local file only, no Artifact).
Install
Copy the folder to ~/.claude/skills/spec-review/ (all projects) or <repo>/.claude/skills/spec-review/ (one repo). Needs Node 18+.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Technical Documentation.
Built and tested with Claude Code only. Send to Claude needs Claude Code signed in to claude.ai (otherwise use Copy feedback or --html). Branching flow diagrams load Mermaid from a CDN; offline they show as a list. Page labels default to Spanish; pass --lang en for English.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 13 days ago
- Free with an Agensi account
- Software
- Claude Code
Node.js 18+