framework-health-check

Validate framework structure, skill contracts, schemas, and conformance evidence.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill framework-health-check-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: framework-health-check
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/framework-health-check
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill framework-health-check-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Governed skill frameworks accumulate structural drift over time: broken contract frontmatter, ownership collisions between skills, dependency cycles, and stale configuration references. This Skill systematically verifies the installed orchestrator framework itself so integrity problems are caught before they corrupt downstream automation. ## Core Features & Use Cases - Contract Integrity Validation: Checks every skill contract for frontmatter integrity, required sections, and naming consistency. - Ownership and Dependency Analysis: Detects output ownership collisions, unowned artifacts, dependency cycles, and missing skill nodes. - Dual-Format Reporting: Emits machine-readable JSON and human-readable Markdown health and conformance reports from the same findings set. - Use Case: Before accepting a batch of skill metadata changes, run a full contract integrity check to pinpoint dependency cycles and ownership conflicts with precise file paths and rule identifiers. ## Quick Start Run a framework health check on this repository and report any contract, ownership, or dependency violations.

Frequently Asked Questions about framework-health-check

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

FAQPage Schema
How do I validate skill contracts in a governed framework?

Run the framework health check to validate each skill contract for frontmatter integrity, required sections, and naming consistency. It reports failures with precise file paths and failed rule identifiers in both JSON and Markdown reports.

How to detect dependency cycles between skills?

The health check compares declared dependencies against known skill IDs and flags cycles or missing nodes. Results appear in the conformance report, traceable to concrete contract evidence.

What is the difference between framework-health-check and audit-code?

framework-health-check verifies the installed orchestrator framework itself, including contracts, schemas, and ownership. Use audit-code instead when you need to assess application code rather than framework structure.

Can the health check fix the problems it finds?

No, it is diagnostic only. It fails closed on missing foundational inputs and requires explicit approval before any remediation step that mutates repository structure or contracts.

What reports does a framework health check produce?

It writes four outputs: framework-health.json, framework-health.md, conformance-report.json, and conformance-report.md. Both formats derive from the same findings set so summary totals always match.