🧾
QualityTypeScript

Spec Review

by saffron-health

Spec Review is a Quality skill for Claude Code, published by saffron-health in libretto.

877 stars67 forkson saffron-health/librettoAdded 2026/08/22Repository updated 2026/08/21
View source on GitHubDownload repo ZIP
automationbrowserclaude-codecodexrpa
Install in seconds
Install Spec Review
Copy Spec Review into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/saffron-health/libretto/tree/main/.agents/skills/spec-review ~/.claude/skills/spec-review

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/saffron-health/libretto.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.agents/skills/spec-review/SKILL.md in saffron-health/libretto
Installs to
~/.claude/skills/spec-review
Collection
One of 23 skills cataloged from this repository
Category
Quality — 1354 skills

What Spec Review does

Spec Review checks a spec for under-specified decisions, design-level bugs, and adherence to the review structure. Use it when you need to critique a spec before implementation.

Spec Review is cataloged under Quality on DirSkills. Spec Review comes from a repository tagged automation, browser, claude-code, codex and rpa.

Documentation

README

Review the spec the user points you to. Follow these steps in order.

Step 1: Read the spec

Read the spec file the user references.

Step 2: Research the codebase

Use sub-agents to read every file listed in the spec's "Important files" section. For each file, understand its current state well enough to evaluate whether the spec's proposed changes are correct and complete.

If the spec references external libraries or APIs, look up their documentation.

Step 3: Evaluate

Assess the spec against three categories. For each finding, cite the specific spec line or section and the relevant source file and line number.

Under-specified areas

Find places where the spec leaves ambiguous decisions that should have explicit design intent from the user. Examples:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Spec Review

  • What else does saffron-health publish alongside Spec Review?

    Spec Review is one of 23 skills that DirSkills catalogs from saffron-health/libretto, the repository it ships in. Its siblings there include Address Review, CLI Development and Errore. Each one is a separate skill with its own page in this directory, installs the same way Spec Review does, and is maintained by saffron-health in that same repository. The rest of the collection is listed on the saffron-health/libretto page.

  • How does Spec Review compare to other Quality skills?

    Spec Review ranks #905 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Spec Review against them. Open each page to compare what they document and how they install.

More from saffron-health/libretto

Spec Review is one of 23 skills cataloged on DirSkills from saffron-health/libretto.

See all 23 skills →
📝
1w ago

Address Review

Address Review systematically fetches PR feedback, applies requested code changes, and verifies them with tests and checks. Use it when responding to human review comments on a pull request.
Automation
87767
⌨️
1w ago

CLI Development

CLI Development designs command-line interfaces with scoped help, clear success messages, and diagnosable failures. Use it when creating or updating commands, argument parsing, exit codes, or human- and machine-friendly CLI output.
Automation
87767
⚠️
1w ago

Errore

Errore is Go-style error handling for TypeScript, where functions return Error | T instead of throwing. Use it when you want typed, visible error handling with early returns and cause chains.
AI Engineering
87767
🖥️
1w ago

External Electron Apps

External Electron Apps automates user-installed Electron desktop apps through Libretto and CDP. Use it to control apps like Slack, VS Code, Discord, Notion, Figma, or Spotify on the user's machine.
Automation
87767
🧩
1w ago

Fix Merge Conflicts

Fix Merge Conflicts resolves Git merge, rebase, and cherry-pick conflicts by checking PR intent and preserving compatible changes from both sides. Use it when unmerged paths or conflict markers need careful resolution before validation.
Automation
87767
📝
1w ago

Generate Spec

Generate Spec creates a spec sheet in the specs directory for a significant feature or complex fix. Use it to research the codebase, clarify open questions, and define goals, non-goals, and an implementation plan.
Writing
87767

More Quality skills

Spec Review is one of 1354 Quality skills cataloged on DirSkills, ranked #905 by stars among them.

Browse all Quality skills →
⏱️
3w ago

Benchmark

Benchmark measures performance baselines, detects regressions before and after PRs, and compares stack alternatives for pages, APIs, and builds.
Quality
239.8K36.4K
⏱️
3w ago

Benchmark Optimization Loop

Benchmark Optimization Loop turns vague performance goals into a bounded, measured optimization process. Use it when asked to make something faster, benchmark latency/throughput/cost, or choose the best implementation by repeated measured tests.
Quality
239.8K36.4K
🔌
3w ago

API Design Patterns

API Design Patterns provides conventions and best practices for designing consistent REST APIs. Use it when creating endpoints, reviewing contracts, handling pagination, error responses, status codes, filtering, or versioning.
Quality
239.8K36.4K