One-click install
npx skills add https://github.com/aaronjmars/aeon --skill config-validator-aaronjmars
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Config Validator
Source: https://github.com/aaronjmars/aeon/tree/main/skills/config-validator
Command: npx skills add https://github.com/aaronjmars/aeon --skill config-validator-aaronjmars

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents full-run outages caused by broken CI workflow structure and configuration drift, such as missing or conditional “Early checkout” ordering, duplicate YAML keys, or enabled skills missing their required SKILL.md files.

Core Features & Use Cases

  • Checkout-ordering validation: Ensures the checkout step runs unconditionally and appears before any conditional steps in .github/workflows/aeon.yml.
  • Duplicate-key detection: Scans aeon.yml for duplicate skill keys that can silently disable skills.
  • Skill file integrity checks: Confirms every enabled: true skill in aeon.yml has a corresponding skills/<name>/SKILL.md.
  • Outage prevention workflow: Produces a CLEAN/ISSUES status and prepares a notification with findings when invariants fail.

Quick Start

Run the Config Validator to validate aeon.yml and .github/workflows/aeon.yml and notify you immediately if structural invariants that historically caused outages are broken.

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 and workflow configuration to prevent agent outages?

Validate aeon.yml and .github/workflows/aeon.yml configuration to prevent agent outages by enforcing checkout ordering, detecting duplicate YAML skill keys, and confirming enabled skills have required SKILL.md files.

Why does my GitHub Actions workflow fail due to broken checkout ordering?

Broken checkout ordering in GitHub Actions workflows causes failures when the checkout step runs conditionally or appears after dependent steps. Config Validator checks that checkout runs unconditionally and before any conditional steps in aeon.yml.

How can I detect duplicate YAML keys that silently disable skills in aeon.yml?

Detect duplicate YAML keys that silently disable skills in aeon.yml by scanning the configuration file for repeated skill keys. Config Validator flags these duplicates during scheduled weekly safety-net runs or pre-merge CI checks.

What happens when a required SKILL.md file is missing for an enabled skill?

When a required SKILL.md file is missing for an enabled skill, configuration validation fails. Config Validator confirms every enabled: true skill entry in aeon.yml has a corresponding skills/<name>/SKILL.md file to prevent runtime errors.

Can I run configuration validation in pre-merge CI contexts?

You can run configuration validation in pre-merge CI contexts. Config Validator applies structural invariant checks to both scheduled weekly safety-net runs and pre-merge CI contexts covering checkout ordering, duplicate keys, and skill file integrity.

What is the best way to notify my team when CI workflow structural invariants break?

The best way to notify your team when CI workflow structural invariants break is to run Config Validator, which produces a CLEAN or ISSUES status and prepares a notification with findings when configuration checks fail.