papi-sdlc-validate-capabilities-dag

Validate capability dependency DAGs in YAML component specifications for cycles and invalid references.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/stainsby/papi --skill papi-sdlc-validate-capabilities-dag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: papi-sdlc-validate-capabilities-dag
Source: https://github.com/stainsby/papi/tree/main/skills/papi-sdlc-validate-capabilities-dag
Command: npx skills add https://github.com/stainsby/papi --skill papi-sdlc-validate-capabilities-dag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires networkx, pyyaml, and includes scripts (resource) components.

What problem does it solve?

This Skill validates the dependency graph that connects component specifications by their capabilities, ensuring the resulting DAG is acyclic and consistent across the SDLC.

Core Features & Use Cases

  • Build and analyze a global capability graph from component specifications and their capability matrices.
  • Detect cycles, orphaned capabilities, and invalid references to prevent incomplete or inconsistent specs.
  • Generate a concise validation report and exit status suitable for CI pipelines to enforce correctness.

Quick Start

Run the validation command against your specs directory to produce a DAG health report.

Frequently Asked Questions about papi-sdlc-validate-capabilities-dag

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

FAQPage Schema
How do I validate a capability dependency graph for cycles in YAML component specs?

This Skill validates a capability dependency DAG by parsing YAML-defined capability matrices across component specifications to detect cycles. It generates a structured report detailing DAG status, orphaned capabilities, and invalid references.

What is a capability DAG and why do cycles cause issues in the SDLC?

A capability DAG maps dependencies between component specifications. Cycles create circular dependencies that break architecture consistency, requiring early remediation during design and review to prevent incomplete or inconsistent specs.

How do I check for orphaned capabilities and invalid references in my component specifications?

You can check for orphaned capabilities and invalid references by building a global capability graph from component specifications. The validation process detects these issues to prevent incomplete or inconsistent specs from progressing in the SDLC.

Can I use networkx to validate a dependency graph across multiple component specs?

Yes, networkx is used to build and analyze the global capability graph from component specifications. It validates the DAG structure to ensure dependencies remain acyclic and references remain consistent across the SDLC.

How do I integrate DAG validation into my CI pipeline to enforce spec correctness?

You can integrate DAG validation into CI pipelines by running the validation command against your specs directory. It emits a concise validation report and exit status suitable for CI pipelines to enforce spec correctness.