dev-review-diagrams

Validate lesson diagrams against README content before pushing.

36|6|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Nebulavenus/forge-gpu --skill dev-review-diagrams-nebulavenus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-review-diagrams
Source: https://github.com/Nebulavenus/forge-gpu/tree/main/.claude/skills/dev-review-diagrams
Command: npx skills add https://github.com/Nebulavenus/forge-gpu --skill dev-review-diagrams-nebulavenus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that each lesson diagram matches its README documentation, catching inconsistencies before they reach review.

Core Features & Use Cases

  • Cross-checks all registered diagrams against the corresponding lesson README to ensure accuracy.
  • Parses the diagrams' code references and the README descriptions to verify data flow, axis labeling, and pipeline steps.
  • Integrates into pre-push or CI workflows to prevent diagram-related regressions in GPU, math, and engine tracks.

Quick Start

Run the diagram review on the current branch to validate all diagrams against their READMEs.

Frequently Asked Questions about dev-review-diagrams

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

FAQPage Schema
How do I validate diagram correctness against a README before pushing?

To validate diagram correctness before pushing, you cross-check registered diagrams against lesson README content, parsing diagram code references and README descriptions to verify data flow, axis labeling, and pipeline steps.

How does diagram validation in CI prevent documentation regressions?

Diagram validation in CI prevents regressions by integrating pre-push checks that cross-reference the DIAGRAMS dictionary with README documentation, catching inconsistencies in GPU, math, and engine tracks before they reach review.

Can I automate diagram review for lessons that include diagrams and README descriptions?

Yes, you can automate diagram review by reading scripts/forge_diagrams to enumerate registered diagrams, parsing lesson READMEs to extract descriptions, and executing verification logic to ensure the diagram matches the README.

What is the best way to cross-check registered diagrams against lesson documentation?

The best way to cross-check diagrams against lesson documentation is to parse diagram code references and README descriptions, verifying data flow, axis labeling, and pipeline steps for consistency before pushing changes.

Does diagram review work with CI workflows for engine and math tracks?

Yes, diagram review integrates into pre-push or CI workflows to prevent diagram-related regressions specifically in GPU, math, and engine tracks by validating diagram correctness against README documentation.

Why does my lesson diagram not match the README description after updates?

Your lesson diagram may not match the README because the verification logic checks the DIAGRAMS dictionary against README content, detecting inconsistencies in data flow, axis labeling, or pipeline steps that require correction before pushing.