gaia-self-check

Inspect .claude components and report metadata inconsistencies for user approval.

3|1|Updated Nov 10, 2025

Search Tags:#consistency #audit #reporting #frontmatter #cross-reference #gaia #self-check

Ready to run

npx skills add https://github.com/metraton/gaia --skill gaia-self-check

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gaia-self-check
Source: https://github.com/metraton/gaia/tree/main/skills/gaia-self-check
Command: npx skills add https://github.com/metraton/gaia --skill gaia-self-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates the internal consistency of a Gaia installation by inspecting only .claude/ on disk, surfacing cross-reference issues, missing references, and readme drift, while never modifying files automatically.

Core Features & Use Cases

Inventory .claude/ components (skills, agents, commands, hooks) and extract frontmatter metadata.
Validate frontmatter structure, cross-references, routing consistency, and README alignment.
Produce a human-readable report plus concrete proposals for fixes, which are only applied after explicit user approval.

Quick Start

Run the Gaia self-check to inventory .claude components and generate a report of inconsistencies for user review.

Frequently Asked Questions about gaia-self-check

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

FAQPage Schema

How do I audit my .claude workspace for metadata inconsistencies?▼

You can audit a .claude workspace by inventorying skills, agents, commands, and hooks to extract frontmatter metadata and validate cross-references. This process surfaces missing references and readme drift, generating a structured report for review.

Can I automatically fix cross-reference issues in my Gaia installation?▼

No, cross-reference issues are not fixed automatically. The self-check enforces an ask-before-fix workflow by generating concrete proposals that require explicit user approval before any changes are applied to the installation.

What is frontmatter validation for .claude components?▼

Frontmatter validation is the process of inspecting the declared metadata structure of .claude components to ensure routing consistency and alignment. It checks for readme drift and structural gaps between declared metadata and the actual on-disk state.

How do I check for readme drift and missing references in my workspace?▼

You check for readme drift by running a consistency audit that inspects the .claude directory on disk. This compares declared component metadata against actual files, producing a human-readable report detailing any misaligned references.

Does the Gaia self-check modify files when it finds routing inconsistencies?▼

No, the self-check never modifies files automatically when routing inconsistencies are found. It produces a structured report and a set of proposals, requiring explicit user approval to enforce a safe ask-before-fix workflow.

What is the best way to inventory .claude hooks and commands for consistency?▼

The best way to inventory .claude components is to run a self-check that scans the workspace on disk. This extracts frontmatter from hooks and commands, validates cross-references, and outputs a structured report for user review.