Why does it warn about trigger phrase overlaps?

If two skills share similar trigger keywords, Claude might become confused about which skill to activate. This check helps you maintain unique triggers for more reliable AI behavior.

Can I use this validator in my automated workflows?

Yes, it is designed for CI/CD integration. It includes a pre-configured GitHub Actions workflow and returns standard exit codes (0 for success, 1 for failure) to gate builds.

What specifically does ss-skill-validate check for?

It validates required YAML frontmatter fields (name, description), ensures the 'ss-' naming prefix is present, verifies directory name matching, checks for broken dependencies, and audits trigger phrase overlaps.

Is the 'ss-' prefix mandatory for all skills?

Within the Skill Sommelier ecosystem, the 'ss-' prefix is a required naming convention that this tool enforces to ensure a standardized and organized repository.

Does it automatically fix the errors it finds?

No, it is a validation and linting tool. To improve or fix the actual content and quality of a skill, you should use the companion tool ss-skill-craft.

Skill Sommelier Validator

Name: Skill Sommelier Validator
Author: JasonLo

byJasonLo

0•

Herramientas para Desarrolladores

Validates Claude Code skills for frontmatter correctness, naming conventions, and structural integrity to ensure production readiness.

ss-skill-validate is a specialized auditing utility designed to maintain high standards across your Claude Code skill repository. It automatically scans your skill directories to verify required metadata, enforces the 'ss-' naming prefix, checks for broken dependencies, and flags potential trigger phrase overlaps that could cause ambiguous AI behavior. Whether used during local development or integrated into a CI/CD pipeline like GitHub Actions, this tool ensures that every skill is perfectly formatted, structurally sound, and ready for deployment.

Características Principales

010 GitHub stars

02Trigger phrase overlap detection to minimize ambiguous skill activation

03Integrated GitHub Actions support for automated CI/CD gating

04Dependency and cross-reference auditing to prevent broken skill links

05Automated YAML frontmatter validation for required fields and formatting

06Strict enforcement of naming conventions and directory structure consistency

Casos de Uso

01Implementing automated CI gates to prevent malformed skills from being merged

02Performing a pre-release audit of a skill library to ensure repository health

03Validating new skills for structural errors before submitting a pull request

Características Principales

010 GitHub stars

02Trigger phrase overlap detection to minimize ambiguous skill activation

03Integrated GitHub Actions support for automated CI/CD gating

04Dependency and cross-reference auditing to prevent broken skill links

05Automated YAML frontmatter validation for required fields and formatting

06Strict enforcement of naming conventions and directory structure consistency

Casos de Uso

01Implementing automated CI gates to prevent malformed skills from being merged

02Performing a pre-release audit of a skill library to ensure repository health

03Validating new skills for structural errors before submitting a pull request