CLI Tool

The airs CLI is a TypeScript-based validator that ensures all skills follow the required schema. It's useful for contributors validating their work locally.

What It Does

Validates YAML front matter in SKILL.md files
Checks required fields: id, title, summary, category, tags, author, license, last_updated
Enforces valid category values (research or analysis)
Ensures unique skill IDs
Validates ID prefix matches category
Optionally checks path-ID alignment in strict mode

Installation

Option 1: Run via npm (recommended)

npm install
npm run validate

Option 2: Run directly with `tsx` (advanced)

tsx tools/airs.ts validate

Usage

Basic Validation

npm run validate

Validates all skills/**/SKILL.md files (excluding _template).

Strict Mode

npm run validate:strict

In strict mode, path-ID misalignment becomes an error instead of a warning.

Example Output

Validating 2 skill(s)...

✓ analysis/textual-analysis-basic/SKILL.md
✓ research/reference-formatting/SKILL.md

All skills valid!

Error Example

Validating 1 skill(s)...

❌ research/my-new-skill/SKILL.md
   - Missing required field: author
   - Missing required field: license

Validation failed.

Exit Codes

Code	Meaning
0	All skills valid
1	Validation errors found

Taxonomy - Field definitions and naming conventions
Contribute - How to add new skills