skills-check

Name: skills-check
Availability: InStock
Author: Outfitter

Validate Claude Code skills against the Agent Skills specification.

28|1|Updated Aug 30, 2025

Search Tags:#documentation #validation #yaml #improvement #skill-check

Ready to run

npx skills add https://github.com/outfitter-dev/agents --skill skills-check-outfitter-dev

💬 Prompt for ChatGPT / Claude Chat▼

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.