Validation System

This repository uses automated validation to ensure code quality across all plugins, extensions, and powers.

Quick Start

bun install      # Install dependencies + set up pre-commit hooks
bun run validate # Run all validations

Component	Validation	Tool
Claude plugin.json	Schema, required fields	`claude plugin validate` CLI
Claude SKILL.md	YAML frontmatter + name-directory match	Ajv (agentskills.io spec)
Claude commands/*.md	YAML frontmatter schema	Ajv + gray-matter
Claude agents/*.md	YAML frontmatter schema	Ajv + gray-matter
Kiro POWER.md	YAML frontmatter schema	Ajv + gray-matter
Bash scripts	Syntax + permissions	ShellCheck
All JSON files	Syntax	JSON.parse
MCP configs	URL consistency	Custom checker
Codex plugin manifests	JSON schema	Ajv
Codex marketplace	JSON schema + path checks	Ajv

bun run validate              # All validations (bulk)

Per-plugin / per-target / per-validator slices are not exposed as scripts — they are debugging filters. Use the CLI directly when needed:

bun validation/src/index.ts --claude-only
bun validation/src/index.ts --codex-only
bun validation/src/index.ts --copilot-cowork-only

Validation runs automatically before each commit via Husky.

.husky/pre-commit → bun run validate

To skip (not recommended):

git commit --no-verify -m "message"

GitHub Actions runs validation on every push and PR to main:

# .github/workflows/validate.yml
- run: bun install
- run: bun run validate