ds-plan-reviewer

Review data science plan documents for spec alignment and implementation readiness.

19|5|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/edwinhu/workflows --skill ds-plan-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ds-plan-reviewer
Source: https://github.com/edwinhu/workflows/tree/main/lib/skills/ds-plan-reviewer
Command: npx skills add https://github.com/edwinhu/workflows --skill ds-plan-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill prevents costly rework by ensuring data science plans are thoroughly reviewed for completeness, spec alignment, and task decomposition before implementation begins.

Core Features & Use Cases

  • Proactive Plan Auditing: Catches critical gaps in data science plans before implementation.
  • Spec Alignment Verification: Ensures the plan directly addresses all requirements in the specification document.
  • Task Granularity Check: Verifies that tasks are atomic, well-ordered, and include clear intermediate output definitions and verification steps.
  • Use Case: Before a data science project moves to coding, this skill acts as a gatekeeper, reviewing the PLAN.md to confirm that all necessary data profiling, cleaning, analysis, and visualization steps are clearly defined and aligned with the SPEC.md.

Quick Start

Use the ds-plan-reviewer skill to review the data science plan document located at .claude/PLAN.md against the spec at .claude/SPEC.md.

Frequently Asked Questions about ds-plan-reviewer

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

FAQPage Schema
How do I review a data science plan for implementation readiness?

To review a data science plan for implementation readiness, validate its task decomposition, spec alignment, and verification steps against the original specification. This process ensures all data profiling, cleaning, and analysis tasks are atomic and well-ordered before coding begins.

What is the Iron Law of Plan Review in data science workflows?

The Iron Law of Plan Review is a principle enforcing strict validation of data science plans to prevent costly implementation rework. It ensures plan documents are thoroughly checked for spec alignment, completeness, and proper task granularity before development starts.

How do I check if my data science plan aligns with the project specification?

Check data science plan alignment by comparing the plan document directly against the specification to verify all requirements are addressed. This validates that intermediate outputs and task decomposition correctly map to the defined data profiling and analysis steps.

Can I audit task decomposition and intermediate outputs in a data science plan?

Yes, you can audit task decomposition and intermediate outputs by verifying that each task is atomic, well-ordered, and includes clear verification steps. This ensures the plan defines necessary data cleaning, analysis, and visualization steps completely.

Does data science plan review work with markdown spec and plan documents?

Yes, data science plan review works directly with markdown documents by reviewing the PLAN.md file against the SPEC.md file. This validates task granularity and specification alignment to prevent rework before implementation begins.

What are the limitations of manual data science plan reviews before implementation?

Manual data science plan reviews often miss critical gaps in task granularity and spec alignment, leading to costly implementation rework. Automated plan auditing catches these completeness issues by strictly validating intermediate outputs and verification steps.