Skip to content
cccskills
FreePublished on GitHub

code-review

Review Spec Kit code changes against relevant design documents, tests for expected and unwanted behavior, evidence that bug fixes prevent recurrence, and repository terminology. Findings identify the document sections behind design mismatches.

OriginalShow the original description

Reviews Spec Kit code changes for consistency with applicable design documents, positive and negative test coverage, regression evidence for bug fixes, and consistent repository terminology. Use when reviewing a diff or pull request. Do not use for implementing changes or posting GitHub review actions.

Works withGitHub
See how to install

Good for

  • Reviewing a Spec Kit pull request
  • Checking test coverage for expected and unwanted behavior
  • Checking regression evidence for a bug fix
  • Assessing consistency with design documents

Files included (1)

  • SKILL.md1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Code Review

  1. Ensure each code change has test cases that verify what the code should do and what it should prevent.
  2. Ensure bug-fix pull requests include a regression test that demonstrates the bug was reproducible before the change and is fixed afterward; if the reviewer cannot run the comparison, use available evidence and state that limitation.
  3. Ensure wording changes use repository-consistent terms; exclude community-authored catalog content and its generated documentation from this check.
  4. Identify the affected domains and read the applicable documents in design/ before evaluating architectural consistency. For CLI command changes, use design/cli.md; for agent integrations, use design/integration.md; for workflow step types, use design/workflow-step.md. Read other design documents when relevant, not every document for every PR.
  5. Check the changes against the applicable design requirements, including implementation boundaries, ownership, lifecycle, and delivery requirements. Reference the documents rather than duplicating their rules in this skill. Cite the document and section for each reported mismatch.
  6. Distinguish an unexplained design violation from an intentional design change. Evaluate the rationale and evidence for an intentional change; updating the design document alone does not establish that the implementation is justified.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Process GitHub issues submitted for Spec Kit community extensions. Validate release details and required files, add or update the catalog and documentation table, and prepare a pull request with a validation summary.

  • Adding a newly submitted community extension
  • Updating an extension version or metadata
  • Checking submissions against publishing rules
github/spec-kit141.8KUpdated Oct 17, 2026

See all skills by github

Report a problem with this skill