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

Related

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