How does it handle Mermaid diagrams?

The skill integrates with the mermaid-collab MCP server to verify visual representations of architecture or flow exist before passing the gate.

What sections does this skill validate in a design document?

It specifically checks for a Problem/Goal statement, Key Decisions with rationale, at least one Diagram, Success Criteria, and an Out of Scope section.

Is there a manual confirmation step?

Yes, once the automated gate passes, the skill uses a browser-based UI or command line prompt to ask for final user confirmation before proceeding.

What happens if a design fails the validation check?

The skill identifies specific gaps, lists the missing components, and redirects the workflow back to the designing phase to address the issues.

Design Validation & Gatekeeping

Name: Design Validation & Gatekeeping
Author: ben-mad-jlp

byben-mad-jlp

•

Collaboration Tools

Ensures technical designs are complete and implementation-ready by verifying required documentation sections and visual diagrams.

The Brainstorming Validating skill acts as a quality assurance gate for the technical design process within Claude Code. It automatically audits design documents for essential components such as problem statements, architectural decisions, Mermaid diagrams, and measurable success criteria. By enforcing a standardized completeness gate, it prevents premature implementation and ensures that developers have a clear, unambiguous roadmap before transitioning to the coding phase.

Key Features

01Verification of required Mermaid architectural diagrams

02Real-time session state management via MCP integration

03Interactive UI-based confirmation for workflow transitions

04Automated completeness checks for technical design documents

051 GitHub stars

06Enforcement of success criteria and project boundaries

Use Cases

01Verifying that a feature design has clear success metrics before coding begins

02Ensuring architectural diagrams are present in technical specifications

03Standardizing the transition from brainstorming to implementation phases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ben-mad-jlp/claude-mermaid-collab brainstorming-validating

For use in Claude.ai and ChatGPT

Download Skill