validate-skill

To validate skill directory structure against the AgentSkills spec, run the validate-skill script with bunx followed by your target directory path. It checks required frontmatter fields and directory naming rules to ensure compliance.

AgentSkills skill directories require frontmatter fields including name and description. The validate-skill script enforces these required fields to prevent invalid skills from entering the ecosystem.

Yes, you can use skill validation in CI pipelines by enabling the JSON output option. This allows automated tooling to parse validation results and enforce skill structure checks during PR reviews and publishing workflows.

Skill validation works with directories such as .claude/skills and .cursor/skills. It enforces naming conventions and frontmatter requirements across these skill directories before publishing.

Run skill directory validation when creating new skills, reviewing PRs that modify skills, or validating skill structure before publishing. This prevents invalid skills from entering your ecosystem.

If your skill directory naming conventions are incorrect, validation fails and reports the naming rule violations. The script enforces strict directory naming rules to maintain spec compliance across skill directories.