skills.rest
outfitter-dev
outfitter-devOFFICIAL
Explore all skills by this author →
Website𝕏@outfitter_devGitHub

skills-check

Validate Claude Code skills against the Agent Skills specification.

28|1|Updated Aug 30, 2025
Search Tags:#documentation#validation#yaml#improvement#skill-check
One-click install
npx skills add https://github.com/outfitter-dev/agents --skill skills-check-outfitter-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skills-check
Source: https://github.com/outfitter-dev/agents/tree/main/agent-kit/skills/skills-check
Command: npx skills add https://github.com/outfitter-dev/agents --skill skills-check-outfitter-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill validates Claude Code skills against the Agent Skills spec, checks YAML syntax, naming, description quality, structure, and best practices, and suggests improvements.

Core Features & Use Cases

  • Syntax & structure validation: YAML frontmatter and referenced files.
  • Quality review: Discoverability, clarity, conciseness.
  • Improvement suggestions: Before/after examples and optional fixes.

Quick Start

Run a skill check against a given skill directory to surface issues and suggested improvements.

Frequently Asked Questions about skills-check

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

FAQPage Schema
How do I validate my Claude Code skill against the Agent Skills specification?▼

Run skills-check against your skill directory to validate YAML frontmatter, naming conventions, required fields (name, description), and file structure. The tool checks syntax, enforces best practices, and surfaces issues before commit or deployment.

What does skills-check validate in YAML skill definitions?▼

Skills-check validates YAML frontmatter structure, required fields, optional metadata fields (allowed-tools, license, compatibility), strict naming rules, description quality (WHAT, WHEN, TRIGGERS format), and referenced file existence to ensure spec compliance.

Can I automatically fix skill quality issues that skills-check identifies?▼

Yes. Skills-check generates before/after improvement examples and offers optional automatic fixes for issues it detects, enabling you to review suggestions and apply corrections directly to your skill definition.

When should I run skill validation as part of my development workflow?▼

Run skills-check before committing changes or when using --check-skill, --validate-skill, or --review-skill flags. This catches naming, structure, and description quality issues early and ensures your skill meets Agent Skills spec requirements.

What's the difference between syntax validation and quality review in skills-check?▼

Syntax validation checks YAML structure and required fields; quality review assesses description clarity, conciseness, discoverability, and adherence to best practices. Skills-check performs both to ensure your skill is both valid and well-documented.

Does skills-check work without external dependencies?▼

Yes. Skills-check has no external dependencies listed, making it lightweight for local skill validation and review workflows without additional tool installation.

Related Skills

Explore More Software Engineering Skills→
elasticelastic
15

input-configurations

Validate SKILL.md frontmatter and extract metadata into a YAML block.

Official
Intermediate
superluminar-iosuperluminar-io
10

api-contract-check

Validate implementations or plans against published API contracts from a registry.

Official
Advanced
WellApp-aiWellApp-ai
341

pr-review

Automate code review with ReadLints lint/type checks and shell-based validation.

Official
Advanced
galligangalligan
1

skills-check

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

Community
Basic