skill-lint

To check a Claude Code skill for anti-patterns, audit the skill directory to validate SKILL.md frontmatter, verify references integrity, and report findings by severity. The audit detects missing references, outdated files, and wrapper contradictions without rewriting the skill.

Validating skill triggers detects anti-patterns such as missing references, outdated files, wrapper contradictions, and missing frontmatter. The audit enforces frontmatter presence, checks description quality, and verifies references integrity to ensure activation consistency.

Yes, you can audit SKILL.md frontmatter and references without rewriting the skill. The linting process inventories and checks against SKILL.md, references/, and checks.md, generating structured findings organized by severity to guide fixes.

To fix activation integrity issues, run an audit on your skill directory to surface anti-patterns and suggested fixes. The audit checks triggers, consistency, and activation integrity, then generates structured findings organized by severity to guide corrections.

The best way to ensure description quality and references integrity is to run a skill audit that enforces frontmatter presence and evaluates description quality. The audit inventories SKILL.md and references/ directories, reporting any inconsistencies by severity level.

A references directory is optional for auditing skill consistency. The audit applies to skills with SKILL.md frontmatter and optional references/scripts, checking references integrity and reporting findings by severity regardless of directory presence.