ds-spec-reviewer

Validate data science specification documents for completeness and readiness.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill prevents data science projects from starting with incomplete or flawed specifications, saving significant time and resources by catching issues early in the development lifecycle.

Core Features & Use Cases

  • Automated Spec Review: Dispatches a subagent to rigorously check SPEC.md for completeness and adherence to best practices.
  • Issue Identification: Flags specific gaps in data sources, objectives, output formats, and success criteria.
  • Iterative Improvement: Facilitates a feedback loop for spec refinement before proceeding to planning.
  • Use Case: Before a data scientist begins planning a new analysis, this skill ensures the SPEC.md document clearly defines all necessary data sources, the precise questions to be answered, and the expected deliverables, preventing costly rework later.

Quick Start

Use the ds-spec-reviewer skill to verify the completeness of the .claude/SPEC.md file.

Frequently Asked Questions about ds-spec-reviewer

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

FAQPage Schema
How do I validate the completeness of a data science specification before planning?

You can validate a data science specification by running an automated reviewer against your SPEC.md to identify gaps in data sources, analysis objectives, output formats, and success criteria before planning begins.

What is specification review in data science project planning?

Specification review is evaluating a SPEC.md document against a predefined checklist to ensure all critical components like data sources and success criteria are addressed, preventing downstream issues and costly rework.

Why does my data science project need spec validation before development?

Data science projects require spec validation to catch incomplete specifications early, saving significant time and resources by preventing costly rework and downstream issues during the development lifecycle.

How do I check if my SPEC.md has gaps in data sources and success criteria?

Check your SPEC.md for gaps by using an automated reviewer subagent that evaluates the document against a predefined checklist, specifically flagging missing data sources, objectives, output formats, and success criteria.

Can I use an automated spec reviewer to ensure data science readiness?

Yes, you can use an automated spec reviewer to ensure data science readiness by verifying the completeness of your SPEC.md file and facilitating an iterative feedback loop for spec refinement.

What are the limitations of automated specification review for data science?

Automated specification review evaluates a SPEC.md strictly against a predefined checklist, meaning it identifies structural gaps in data sources and objectives but does not assess the technical feasibility of the analysis itself.