Run any Skill in Manus with one click

review-spec

Review design specs for correctness, completeness, consistency, quality, implementability, and risks. Verifies claims against source code. Invoke with /review-spec <path-to-spec>.

Run Skill in Manus

Overview

Review design specs for correctness, completeness, consistency, quality, implementability, and risks. Verifies claims against source code. Invoke with /review-spec <path-to-spec>.

Install command

npx skills add https://github.com/jonbarksdale/dotfiles --skill review-spec

Copy and paste this command into Claude Code to install the skill

Source

jonbarksdale/dotfiles

Stars4

Forks0

UpdatedApril 19, 2026 at 20:01

File Explorer

2 files

SKILL.md

readonly

More from this repository

same repository

graphify

jonbarksdale/dotfiles

any input (code, docs, papers, images, videos) to knowledge graph. Use when user asks any question about a codebase, documents, or project content - especially if graphify-out/ exists, treat the question as a /graphify query.

2026-05-214

graphite

jonbarksdale/dotfiles

Graphite CLI (gt) patterns for managing stacked pull requests. Use whenever the user mentions graphite, the `gt` command, PR stacks, or stacked diffs. Also triggers when starting development work in a repository where graphite is initialized (`.git/refs/graphite` exists or `gt` commands have been used). Invoke proactively when the user is creating branches, submitting PRs, or navigating between related branches in a collaborative repo — even if they don't mention graphite by name.

2026-04-164

estimating

jonbarksdale/dotfiles

Use when creating issues, reviewing unestimated backlog items, or asked to estimate effort. Encodes the fibonacci scale and drives session/agent planning decisions.

2026-04-124

finish-ticket

jonbarksdale/dotfiles

Complete a development ticket end-to-end: root-cause any test failures, run the full test suite, lint and typecheck, commit, fast-forward merge to main, update the issue tracker to Done, and file follow-up issues for gaps. Invoke with /finish-ticket <ISSUE-ID>.

2026-04-124

preflight

jonbarksdale/dotfiles

Session start check for MCP auth, git state, and worktree environment. Run at the start of any session involving MCP servers to surface expired tokens and env drift before they interrupt real work.

2026-04-124

technical-writing

jonbarksdale/dotfiles

Technical documentation standards for both writing and reviewing. Use when creating new documentation, writing ADRs, drafting technical specs, reviewing existing docs for quality, or critiquing technical writing. Triggers on any documentation task, whether creating, editing, or reviewing.

2026-03-104

Source

jonbarksdale

jonbarksdale/dotfiles

View GitHub Repository View Creator Repositories

Install command

Download

Run Skill in Manus

Useful forSOC

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations15-1253L4

name	review-spec
description	Review design specs for correctness, completeness, consistency, quality, implementability, and risks. Verifies claims against source code. Invoke with /review-spec <path-to-spec>.

Design Spec Review

Review implementation design specs by verifying claims against source code and evaluating across six dimensions.

Quick Reference

Process:

Read the spec and identify every verifiable claim
Cross-reference claims against source code (line numbers, signatures, patterns)
Check alignment with project standards (CLAUDE.md, existing conventions)
Report findings by dimension, skip clean dimensions

Dimensions:

Correctness: Are verifiable claims true? (line numbers, signatures, precedent citations)
Completeness: Any gaps, missing scenarios, or unaddressed edge cases?
Consistency: Does the design align with project standards and existing patterns?
Quality: Latent defects, error-prone interfaces, fragile assumptions?
Implementability: Can someone implement without ambiguity or unstated decisions?
Risks: What could go wrong? (security, performance, rollback when relevant)

Output: Narrative findings by dimension, ending with a summary of substantive issues. Skip dimensions with nothing to report.

See reference.md for detailed standards.