gpd-graph

Builds and visualizes dependency graphs across research phases from SUMMARY.md frontmatter.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-graph-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-graph
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-graph
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-graph-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research projects with multiple phases often lose track of how results flow between phases, leading to unmet dependencies, orphaned outputs, and unclear critical paths. This Skill parses phase metadata to construct a directed dependency graph, detect gaps, and compute the critical path through the research roadmap. ## Core Features & Use Cases - Dependency Graph Construction: Parses provides/requires/affects fields from SUMMARY.md frontmatter and ROADMAP.md phase definitions to build a directed graph of phase relationships. - Gap and Cycle Detection: Identifies unmet requirements, orphaned provides, missing phases, and circular dependencies with severity ratings. - Visualization and Critical Path: Generates Mermaid, ASCII, DOT, or JSON graph output with status-based node coloring, plus the longest sequential dependency chain. - Use Case: Before planning Phase 4 of a physics research project, run this Skill to confirm that Phase 2 actually provides the dispersion-relation result Phase 4 requires, and to see which phases can be parallelized. ## Quick Start Ask the AI to visualize the dependency graph across all research phases and identify any gaps or unsatisfied requirements.

Frequently Asked Questions about gpd-graph

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

FAQPage Schema
How do I visualize dependencies between research project phases?▼

Run the graph workflow, which scans all SUMMARY.md frontmatter for provides, requires, and affects fields, then builds a directed graph rendered as Mermaid, ASCII, DOT, or JSON. Nodes are colored by phase status: complete, partial, planned, or empty.

How to detect missing dependencies in a research roadmap?▼

The gap analysis step flags unmet requires where a phase needs a result no other phase provides, missing phase references in ROADMAP.md, and circular dependencies. Each gap is categorized by severity from low to critical.

What metadata does the dependency graph read from phase files?▼

It reads YAML frontmatter in SUMMARY.md files: provides for results a phase produces, requires for results it needs from earlier phases, and affects for conventions it establishes. It also reads the Dependencies field from ROADMAP.md phase definitions.

Can the graph work without SUMMARY.md files?▼

Yes, it falls back to ROADMAP.md phase dependencies when SUMMARY frontmatter is absent. Phases without SUMMARY files still appear as nodes with planned or empty status rather than being skipped.

What output formats does the dependency graph support?▼

It supports Mermaid for markdown embedding, ASCII for terminal inspection, DOT for Graphviz-compatible output, and JSON for downstream tooling. The report can optionally be written to .gpd/DEPENDENCY-GRAPH.md.

Why does the graph command report an error about phases?▼

The dependency graph requires at least two phases and an existing ROADMAP.md. With fewer than two phases or no roadmap, it exits with an error and suggests creating a project first.