phase-reviewer

Review phase plan documents against a specification for user story referencing, textual correctness, and formatting consistency.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/wtsi-hgi/llm-knowledge-base --skill phase-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-reviewer
Source: https://github.com/wtsi-hgi/llm-knowledge-base/tree/main/.github/skills/phase-reviewer
Command: npx skills add https://github.com/wtsi-hgi/llm-knowledge-base --skill phase-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the rigorous review of phase plan documents, ensuring they align with specifications, maintain textual quality, and adhere to structural consistency, thereby reducing errors and improving project clarity.

Core Features & Use Cases

  • Spec Compliance Verification: Checks if phase files accurately reference and conform to user stories defined in a spec document.
  • Textual Quality Assurance: Identifies and corrects common LLM-generated text errors like repetition, contradictions, and undefined terms.
  • Formatting and Consistency Checks: Enforces strict formatting rules, including item numbering, batch structure, ASCII compliance, and line wrapping.
  • Automated Error Correction: Directly fixes identified errors in phase files, using the spec as the source of truth.
  • Use Case: A project manager can use this Skill to automatically proofread a newly drafted phase plan document before it's finalized, catching any discrepancies with the main project specification and ensuring all technical requirements are met.

Quick Start

Use the phase-reviewer skill to review the document located at .docs/myfeature/phase3.md against the spec document at .docs/spec.md.

Frequently Asked Questions about phase-reviewer

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

FAQPage Schema
How do I verify my phase plan document matches the project specification?

Spec compliance verification checks if phase files accurately reference and conform to user stories defined in a specification document, ensuring technical requirements are met before finalizing the plan.

How do I fix LLM-generated text errors like repetition and undefined terms in markdown files?

Textual quality assurance identifies and corrects common LLM-generated text errors like repetition, contradictions, and undefined terms directly within the phase file to maintain project clarity.

What is the best way to enforce formatting and consistency in phase plan documents?

Formatting and consistency checks enforce strict formatting rules, including item numbering, batch structure, ASCII compliance, and line wrapping, by directly correcting errors in the phase file.

Does the phase-reviewer skill operate as a standalone document validator?

No, the phase-reviewer operates as a subagent invoked by an orchestrator rather than directly by the user, automating rigorous review of phase plan documents for specification adherence.

Can I automatically correct phase plan discrepancies against a specification document?

Yes, automated error correction directly fixes identified discrepancies in phase files using the specification document as the source of truth, catching any deviations from the main project specification.

What are the limitations of using an automated specification review for phase plans?

A limitation is that it operates strictly as a subagent invoked by an orchestrator and cannot be run directly by the user, restricting its use to orchestrated workflows for phase plan validation.