skillscore 0.1.0
skillscore: ^0.1.0 copied to clipboard
Lint and score AI agent skills (SKILL.md) against the official Claude, Codex, and Antigravity authoring guides. Offline, deterministic CLI.
Changelog #
All notable changes to this project are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.1.0 - 2026-06-12 #
Added #
- Initial release of
skillscore. - 24 scoring rules across 7 rubric categories (A frontmatter, B description, C conciseness, D structure, E instruction quality, F hygiene, G safety penalty), each citing its source authoring guide (Anthropic, Antigravity, Codex, Flutter).
- Target profiles:
--target claude | antigravity | codex | universalimplemented as data (per-target rule activation + severity overrides). - Name-agnostic, case-insensitive skill discovery for single manifests, skill folders, and whole directory trees; BOM/CRLF tolerance; graceful handling of malformed frontmatter, binary files, and symlinks.
- Reporters:
pretty(colored, per-category bars),json(stable CI shape), andsarif(valid SARIF 2.1.0). - CI gating via
--min-scoreand--strict; exit codes 0/1/2. skillscore rulesandskillscore explain <rule-id>with rationale, fix, and source citations.