review-spec-local

Review local specifications using temporary directory snapshots and a review.json contract.

144|16|Updated May 3, 2026
One-click install
npx skills add https://github.com/Terry-Mao/AICodingFlow --skill review-spec-local-terry-mao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-spec-local
Source: https://github.com/Terry-Mao/AICodingFlow/tree/main/.agents/skills/review-spec-local
Command: npx skills add https://github.com/Terry-Mao/AICodingFlow --skill review-spec-local-terry-mao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies local spec review, mirroring the GitHub review workflow, ensuring consistent review standards before code submission.

Core Features & Use Cases

  • Local Review: Conduct a local review using temporary directory snapshots.
  • Review JSON Contract: Utilizes the same review.json contract as CI.
  • Safety and Validation: Ensures safety rules are adhered to during the review process.
  • Use Case: Ideal for reviewing specifications before pushing code changes or creating pull requests.

Quick Start

Run the review-spec-local skill with the command: python3 .github/scripts/prepare_local_review_inputs.py

Frequently Asked Questions about review-spec-local

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a local spec review before pushing code changes?

Local spec review uses a temporary-directory snapshot of your current branch to validate review output against the local worktree. It mirrors GitHub review workflows to ensure consistent review standards before code submission or pull request creation.

How does local spec validation integrate with CI review processes?

Local spec validation integrates with CI by utilizing the exact same review.json contract. This ensures that safety rules and review standards adhered to locally will pass seamlessly when the code is eventually submitted to the CI pipeline.

Do I need any external dependencies to perform local spec testing?

You can use this local spec review tool for any scale of code changes that require validation against safety rules and review.json standards. It is ideal for validating specifications locally before creating pull requests.

What is the best way to validate code against review.json standards locally?

The best way to validate code against review.json standards locally is by using a temporary-directory snapshot from your current branch. This approach ensures safety and strict adherence to the contract before integrating with CI.

Why does local spec review use a temporary-directory snapshot?

Local spec review uses a temporary-directory snapshot to isolate and validate the review output against your local worktree safely. This mechanism prevents unintended modifications to your actual branch during the review process.