gaia-validate-framework

Validate GAIA plugin trees against manifest.yaml and generate a findings report.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-validate-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-validate-framework
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-validate-framework
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-validate-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The GAIA framework grows with plugins and artifacts; this skill detects inconsistencies, broken references, and missing components by validating the on-disk tree against the authoritative manifest and knowledge indexes, enabling teams to catch drift early.

Core Features & Use Cases

  • Walks the GAIA plugin tree and compares inventory against ${CLAUDE_PLUGIN_ROOT}/knowledge/manifest.yaml, surfacing gaps and drift.
  • Checks workflow, agent, command, manifest, and knowledge-index integrity and reports unresolved references or missing files.
  • Validates config resolution via scripts/resolve-config.sh and emits a structured findings report suitable for CI and auditing.

Quick Start

Use the gaia-validate-framework skill to run a framework scan and generate a findings report.

Frequently Asked Questions about gaia-validate-framework

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

FAQPage Schema
How do I validate plugin structure and references against a manifest file?

To validate plugin structure and references, you can scan the plugin tree and compare its inventory against an authoritative manifest file to surface gaps, broken references, and missing components.

What is framework integrity validation and when do I need to run it?

Framework integrity validation detects inconsistencies and drift within a plugin framework by checking workflows, agents, commands, and knowledge indexes. You need to run it when your framework grows with new plugins to catch broken references early.

Can I check config resolution and knowledge-index consistency in a single pass?

Yes, you can check config resolution and knowledge-index consistency together by validating configuration scripts and knowledge indexes simultaneously, producing a consolidated findings report suitable for CI pipelines.

What is the best way to audit a plugin tree for missing files and unresolved references?

The best way to audit a plugin tree for missing files and unresolved references is to perform an end-to-end validation against the authoritative manifest, enforcing strict checks on workflows, agents, and configuration resolution.

Does manifest validation work across different plugin areas like lifecycle, dev, and testing?

Manifest validation works across core, lifecycle, dev, creative, and testing plugin areas, walking the entire plugin tree to compare inventory against the manifest and ensure end-to-end consistency.

Why does my config resolution fail during framework validation?

Config resolution fails during framework validation when the configuration cannot be resolved correctly through the designated resolution script, as the validation process enforces strict checks on this resolution to ensure end-to-end consistency.