Spec Review

    1

    `/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

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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/…

    Sections9
    Key decisions4
    Flow diagrams2
    Notes modelSonnet (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

    1. Open the link and go through the sections.
    2. Press Send to Claude. Your review arrives here as a comment.
    3. 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+.

    Source: https://github.com/marcozanger/spec-review-skill

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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 forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 13 days ago

    • Free with an Agensi account

    Requires

    Claude Code
    Node.js 18+

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Network Access
    Listed13 days ago

    What's inside

    Frequently Asked Questions

    Turns a Markdown spec or implementation plan into a review page: OK / Change per section, progress rail, AI summaries, key decisions and flow diagrams. As a claude.ai Artifact, your review goes straight back to Claude, which applies it to the .md.

    This skill uses the open SKILL.md standard. Use it through an MCP-compatible agent connected to Agensi, and check the compatibility information on this page for confirmed agents and required capabilities.

    Connect your AI agent to Agensi through MCP, then ask it to use Spec Review on your task. Your agent loads the latest approved version each time. Paid skills require a purchase or active subscription. Skill files are not available for download; your licence does not allow you to save, copy or export any part of a skill.

    New in Technical Documentation