Validate Skill Schema

Use the schema and validator to keep skills consistent across Upstream, Midstream, and Downstream checks.

Steps

1. Edit or add a skill under skills/.

2. Run the validator:

   npm run skills:validate

3. If the schema check errors, confirm these required fields exist:

   • id
   • name
   • description
   • category (the primary routing key; phase is an optional backward-compatibility alias)
   • applyTo (or files / path_patterns)

4. Confirm category matches the intended flow segment (core / upstream / midstream / downstream) and adjust applyTo globs to avoid noisy matches.

5. Re-run the validator until you get a clean pass, then include the command output in your PR.

Tips

• Keep tags and severity aligned with how you want findings prioritized.
• Add small sample files and open a draft PR to see how the reviewer routes the skill.