Config Validator

Validate aeon.yml and GitHub workflow configurations for structural invariants.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/swarm-ai-research/aeon --skill config-validator-swarm-ai-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Config Validator
Source: https://github.com/swarm-ai-research/aeon/tree/main/skills/config-validator
Command: npx skills add https://github.com/swarm-ai-research/aeon --skill config-validator-swarm-ai-research

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Validate aeon.yml and .github/workflows/aeon.yml for structural invariants that have caused past outages — checkout step ordering, duplicate skill keys, missing skill files.

Core Features & Use Cases

  • Weekly safety net: detects drift in main and PR configurations to prevent outages.
  • Validate critical invariants: checkout ordering, duplicate keys, and enabled-skill integrity.
  • CI integration: can be triggered via the shared validator script used by the repository's CI workflow.

Quick Start

Run node scripts/validate-config.js to execute all checks.

Frequently Asked Questions about Config Validator

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

FAQPage Schema
How do I validate aeon.yml configuration files in CI pipelines?

Validate aeon.yml configuration in CI by running node scripts/validate-config.js to execute centralized checks. It detects structural drift in checkout steps, flags duplicate skill keys, and verifies enabled-skill integrity, outputting alerts for incident prevention.

What GitHub workflow invariants cause outages that config validation can catch?

Config validation catches GitHub workflow invariants like unconditional checkout step ordering, duplicate skill keys, and missing SKILL.md files for enabled skills. These structural issues have caused past outages and are flagged during validation.

Can I run a YAML config validator on a weekly schedule to prevent incidents?

Yes, the config validator is designed for weekly safety net workflows to detect configuration drift in main and PR branches. Running node scripts/validate-config.js regularly prevents outages by catching structural invariant violations early.

Does the config validator check for missing SKILL.md files associated with enabled skills?

Yes, the config validator verifies every enabled skill in aeon.yml has an associated SKILL.md file. It flags duplicate skill keys and missing files, providing outputs suitable for alerting and remediation directly within CI pipelines.

What's the best way to automate repository config validation for checkout step ordering?

Automate repository config validation by integrating the centralized validator script into CI workflows. It ensures checkout steps remain unconditional and detects duplicate keys, providing outputs suitable for automated alerting and remediation.