skill-check

Validate Claude Code skill naming, descriptions, and YAML frontmatter structure.

3|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/spm1001/claude-suite --skill skill-check-spm1001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-check
Source: https://github.com/spm1001/claude-suite/tree/main/skills/skill-check
Command: npx skills add https://github.com/spm1001/claude-suite --skill skill-check-spm1001

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures all new Claude Code skills meet naming, description, and structure standards before deployment, preventing weak or ambiguous skills from being published.

Core Features & Use Cases

  • Enforces mandatory YAML frontmatter with name and description.
  • Validates that the skill name matches the directory (kebab-case) and adheres to the trigger-based description pattern.
  • Provides discovery-ready metadata for tooling and QA workflows.

Quick Start

Use the skill-check to validate a new skill's SKILL.md and ensure it passes the quality gate.

Frequently Asked Questions about skill-check

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

FAQPage Schema
How do I validate YAML frontmatter for Claude Code skills before deployment?

Validating YAML frontmatter for Claude Code skills requires checking that mandatory name and description fields exist and adhere to structural standards. This quality gate ensures weak or ambiguous skills are prevented from being published.

What naming conventions are required for Claude Code skill directories?

Claude Code skill directories must use kebab-case naming conventions. The validation process enforces that the skill name matches its directory name exactly, ensuring consistent discovery and preventing deployment errors.

How do I write a trigger-driven description for a Claude Code skill?

A trigger-driven description for a Claude Code skill clearly defines when and how the skill should activate. This pattern supports risk and anti-pattern checks while providing discovery-ready metadata for tooling and QA workflows.

Do I need a quality check workflow to publish a new Claude Code skill?

A quality check workflow is mandatory before sharing any new Claude Code skill. It enforces naming standards, YAML frontmatter requirements, and trigger-based description patterns, ensuring only validated skills reach deployment.

Why does my Claude Code skill fail the structural validation gate?

Claude Code skills fail the structural validation gate when they lack mandatory YAML frontmatter, use incorrect non-kebab-case names, or have descriptions that do not follow the trigger-based pattern required for risk checks.

Can I use skill-check to provide discovery-ready metadata for QA workflows?

Skill-check provides discovery-ready metadata for tooling and QA workflows by validating SKILL.md files. It enforces structural requirements and integrates with other skills during the skill-creator workflow to ensure quality.