validate-skill

Validate skill frontmatter by running a check against the AgentSkills specification to ensure required fields like name and description exist, and enforce lowercase hyphenated directory names that match the skill name before publishing.

Skill directory validation is the process of checking skill folders against the AgentSkills specification to enforce required frontmatter and naming conventions, needed during PR reviews or pre-publish checks to prevent malformed skills from entering production.

Yes, you can validate skills stored in repository directories like .claude/skills or .cursor/skills by passing the directory path to the validation script, which checks each skill folder against the AgentSkills specification.

Get JSON output when validating skill directories by passing the --json flag along with the target skill path, which reports validation results including errors and warnings in structured JSON format instead of human-readable text.

The required frontmatter fields for an AgentSkills compliant skill are name and description, and the directory name must match the skill name using lowercase and hyphenated naming conventions to pass validation.

Your skill fails validation during a PR review if it is missing required frontmatter fields like name or description, or if the directory name does not match the skill name using lowercase hyphenated conventions specified by AgentSkills.