skills.rest
galligan
galliganCOMMUNITY
Explore all skills by this author →
Website𝕏@mgGitHub

skills-check

Validate and review SKILL.md files against the Agent Skills specification.

1|Updated Dec 23, 2025
Search Tags:#validation#discovery#yaml#review#improvement#frontmatter
One-click install
npx skills add https://github.com/galligan/skillstash --skill skills-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skills-check
Source: https://github.com/galligan/skillstash/tree/main/.agents/skills/skills-check
Command: npx skills add https://github.com/galligan/skillstash --skill skills-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates and reviews skills against the Agent Skills specification. Checks YAML syntax, naming conventions, description quality, file structure, and best practices. Provides improvement suggestions with before/after examples and optionally applies fixes.

Core Features & Use Cases

  • Validation: YAML syntax, required fields, naming matches directory, line length
  • Review: discoverability, conciseness, clarity
  • Improvement suggestions: before/after examples and optional fixes

Quick Start

Use skills-check to validate and review a target SKILL.md (e.g., run against skills/my-skill/SKILL.md).

Frequently Asked Questions about skills-check

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

FAQPage Schema
How do I validate YAML frontmatter syntax in my skill files?▼

YAML frontmatter validation checks syntax, required fields, indentation, quoting rules, and file structure compliance against the Agent Skills specification. Run skills-check against your SKILL.md file to detect errors before commit.

What naming conventions should my skill follow?▼

Skill naming conventions require the skill name to match its directory name and follow specified patterns. skills-check validates your naming against these rules and flags violations with correction suggestions.

How do I improve skill descriptions for discoverability?▼

Skill descriptions need clarity, conciseness, and proper structure following the WHAT, WHEN, TRIGGERS format and voice guidelines. skills-check reviews description quality and provides before/after improvement examples.

Can skills-check automatically fix validation issues?▼

Yes, skills-check identifies YAML syntax errors, structural problems, and best-practice violations, then offers optional automated fixes alongside before/after examples for review.

What file structure requirements does the Agent Skills specification define?▼

The specification defines requirements for YAML frontmatter structure, required fields, line length limits, and file organization. skills-check validates full compliance and anti-pattern avoidance.

Why should I validate skills before committing changes?▼

Pre-commit validation catches YAML syntax errors, naming violations, description gaps, and structural issues early, preventing merge conflicts and ensuring specification compliance across your skill repository.

Related Skills

Explore More Software Engineering Skills→
siderolabssiderolabs
12

siderolabs

Locate root SKILL.md files and generate structured YAML metadata per Skill.

Official
Advanced
pradyumnasagarpradyumnasagar
6

release-management

Manages ORS skill releases with versioning, changelogs, and marketplace updates.

Community
Intermediate
Securability-EngineeringSecurability-Engineering
2

your-skill-name

Define a Skill unit manifest with YAML frontmatter for the securable-claude-plugin repository.

Official
Basic
outfitter-devoutfitter-dev
28

subagent-check

Validate Claude Code subagents against best practices for YAML, prompts, and tools.

Official
Advanced