config-validator

Solid

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

AI & Automation 508 stars 166 forks Updated today MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
90
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

Today is ${today}. Your task is to validate the structural correctness of `aeon.yml` and `.github/workflows/aeon.yml`. This skill exists because two incident classes have caused major outages: - **Checkout-ordering class**: `Early checkout` step missing or conditionally gated — can cause every skill to fail in a single run. - **Duplicate-key class**: duplicate YAML keys in `aeon.yml` — silently disable any skill whose key is shadowed. The same checks also run as a pre-merge CI workflow at `.github/workflows/ci-config-validate.yml` (via `scripts/validate-config.js`) — that workflow blocks PRs that break these invariants. This skill is the **weekly safety net** for state that drifts on `main` outside of PRs (manual edits, scheduled rewrites, post-process commits). Run all checks. Report findings. Alert if any fail. ### Fast path — invoke the shared validator The fastest, most consistent way to run all three checks is the shared script the CI workflow uses: ```bash node scripts/validate-config.js ``` Exit code 0 = CLEAN (no notification needed). Non-zero exit + `FAIL[*]:` lines on stdout = ISSUES (skip to step 4). If the script is unavailable for any reason, fall back to the manual checks in steps 1–3. ## Steps ### 1. Check workflow step ordering (checkout-ordering class) Read `.github/workflows/aeon.yml`. Find the `jobs.run.steps` array. Verify: a. A step named `Early checkout` (or `uses: actions/checkout`) exists. b. That step has **no** `if:` condition — it must r...

Details

Author
aaronjmars
Repository
aaronjmars/aeon
Created
3 months ago
Last Updated
today
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category