What is incremental review mode?

This mode optimizes time by performing a full review on new artifacts while conducting a high-speed consistency check on previously approved artifacts to ensure they still align.

What are the possible review verdicts?

The skill returns a verdict of 'ready' for clean designs, 'needs-revision' for fixable issues, or 'critical-gaps' when major blockers are identified.

How does the skill classify design issues?

Issues are classified into three levels: Critical (blocks progress), Important (significant gaps to resolve), and Minor (polish items that can be deferred).

What does the Validation Plan Artifacts skill do?

It reviews early-stage technical documents like research summaries, data models, and API contracts to identify design gaps and inconsistencies before any code is written.

Design Artifact Validation

Name: Design Artifact Validation
Author: deepeshBodh

bydeepeshBodh

•

Productivity & Workflow

Reviews and validates planning artifacts like research, data models, and API contracts to ensure design completeness before implementation.

The Validation Plan Artifacts skill acts as a rigorous quality assurance layer for the planning phase of software development within Claude Code. It enables Claude to function as a 'Devil's Advocate,' scrutinizing technical research, data schemas, and API contracts for architectural gaps, inconsistencies, and design flaws. By executing phase-specific checklists and classifying issues by severity—Critical, Important, or Minor—it ensures that technical specifications are robust and production-ready before the implementation phase begins, effectively reducing downstream technical debt and rework.

Key Features

01Incremental review mode for efficient cross-artifact consistency checks

02Phase-specific review checklists for Research, Data Models, and API Contracts

03Traceability verification between requirements and design artifacts

047 GitHub stars

05Severity-based issue classification with actionable resolution steps

06Automated verdict generation for 'Ready', 'Needs Revision', or 'Critical Gaps'

Use Cases

01Executing a final phase-gate review to ensure all design decisions are documented before starting code generation

02Validating an API contract against a proposed data model for naming and schema consistency

03Performing a 'Devil's Advocate' review of technical research to identify missing edge cases or PII concerns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add deepeshbodh/human-in-loop validation-plan-artifacts

For use in Claude.ai and ChatGPT

Download Skill