skills.rest
metraton
metratonCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/metraton/gaia --skill gaia-self-check
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
friedbotstudiofriedbotstudio
5

audit-baseline

Detect drift between on-disk baseline implementations and their specifications.

Official
Advanced
1J6K211J6K21

code-review-and-quality

Review code changes across correctness, readability, architecture, security, and performance.

Community
Intermediate
ysgdepaulaysgdepaula

validate-all

Run all validators to verify X-DEEP architecture health and detect drift.

Community
Intermediate
dburkartdburkart
5

sync

Detect drift between project files and auto-engineer templates with interactive pull, push, diff, and skip choices.

Community
Advanced