ss-validate-skills

Validate Claude Code skills for frontmatter, naming, and structural rules.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/JasonLo/skill-sommelier --skill ss-validate-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ss-validate-skills
Source: https://github.com/JasonLo/skill-sommelier/tree/main/skills/ss-validate-skills
Command: npx skills add https://github.com/JasonLo/skill-sommelier --skill ss-validate-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the rigorous checking of all Claude Code skills within a repository, ensuring they adhere to established standards for correctness, naming, and structure, thereby preventing errors and maintaining repository health.

Core Features & Use Cases

  • Automated Validation: Runs comprehensive checks on SKILL.md files, including frontmatter parsing, naming conventions, and structural integrity.
  • Pre-Release Auditing: Acts as a crucial gatekeeper before code merges or releases, catching potential issues early.
  • CI Integration: Easily integrates into GitHub Actions workflows to provide continuous validation.
  • Use Case: Before merging a new skill into the main branch, run ss-validate-skills to confirm it meets all project requirements, preventing broken builds or unexpected behavior.

Quick Start

Run the command to validate all skills in the repository.

Frequently Asked Questions about ss-validate-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Claude Code skills for frontmatter correctness and naming conventions?

Skill validation involves parsing SKILL.md frontmatter, checking naming conventions, and verifying structural rules to ensure repository compliance. This process identifies metadata errors and structural inconsistencies before code merges.

When do I need to run skill validation in my development lifecycle?

Run skill validation during pre-release checks and within GitHub Actions CI pipelines. It acts as a merge gatekeeper, catching frontmatter and structural issues early to prevent broken builds and unexpected runtime behavior.

Can I integrate skill validation into GitHub Actions workflows?

Yes, skill validation integrates into GitHub Actions workflows to provide continuous validation. It automatically checks SKILL.md frontmatter and structural rules during CI pipelines, preventing non-compliant skills from merging.

What's the best way to audit skill files before a code merge?

The best way to audit skill files before merging is to run an automated validation script that checks SKILL.md frontmatter correctness, naming conventions, and structural integrity, confirming all project requirements are met.

Do I need specific tools to discover and verify skill metadata in a repository?

Yes, verifying skill metadata requires glob, grep, and read tools to discover and parse SKILL.md files. These tools locate skill definitions, extract frontmatter, and verify structural rules across the repository.

Why does skill validation fail on SKILL.md files with incorrect frontmatter?

Skill validation fails on incorrect frontmatter because it strictly checks for compliance with established standards. Parsing errors or missing metadata fields prevent the skill from passing pre-release audits and CI pipeline gates.