skill-check

SkillCheck

Overview

Validate SKILL.md files against the agentskills specification and Anthropic best practices. Catches structural errors, semantic contradictions, naming anti-patterns, and quality gaps in a single read-only pass.

When to Use This Skill

• Use when user says "check skill", "skillcheck", or "validate SKILL.md"
• Use when reviewing a skill before publishing to a marketplace
• Use when debugging why a skill doesn't trigger correctly
• Use when onboarding a team to skill authoring standards
• Do NOT use for anti-slop detection, security scanning, or token analysis; use SkillCheck Pro for those

How It Works

Step 1: Parse

Read the target SKILL.md file and extract YAML frontmatter.

Step 2: Validate

Apply all Free tier checks in order:

Category	Checks	What it catches
Structure (1.x)	Name format, description WHAT+WHEN, allowed-tools, categories, XML injection	Malformed frontmatter, missing fields
Body (2.x)	Line count, hardcoded paths, stale dates, empty sections, deprecated syntax, MCP tool qualification	Content quality issues
Naming (3.x)	Vague terms, single-word names, gerund suggestions	Poor discoverability
Semantic (4.x)	Contradictions, ambiguous terms, missing output format, wisdom/platitudes, misplaced trig