skill-linter

Skill validation checks frontmatter fields, directory naming, line limits, and structure against the agentskills.io specification. Run the linter on your skill directory to receive a conformance assessment with actionable remediation notes and pass/fail status for marketplace readiness.

Required frontmatter fields are name and description. Optional fields include license, compatibility, metadata, and allowed-tools. The linter validates that all fields meet length constraints and format requirements.

No. The linter enforces allowed subdirectories only. Your skill directory name must match the skill name, SKILL.md must exist at the root, and only permitted subdirectories are permitted within the plugins/*/skills/* hierarchy.

Execute ./scripts/validate-skill.sh with your skill directory path. The linter outputs conformance results and pass/fail status, enabling automated quality gating in CI checks and pull request validation workflows.

The linter provides actionable remediation notes identifying specific violations—missing fields, naming mismatches, line limit overages, or disallowed subdirectories. Fix issues according to the notes and rerun validation until the skill achieves pass status.

Yes. Line limits are enforced on description and other frontmatter fields as part of the agentskills.io specification. The linter reports any violations and specifies the maximum allowed length for each field.