SkillCheck validates your Agent Skills against the open standard. Pro adds accessibility, security, and anti-slop checks. Built for Claude Code.
Built for Claude Code · Follows the Agent Skills open standard · v3.15.0
Validates Agent Skills anywhere they're used. Pro connects as an MCP tool server.
Design Pattern Classification (Free)
Pro: Pattern, Artifact, and Collision Checks
Agent Skills are now an open standard adopted by Microsoft, Cursor, and dozens of coding agents. Your skill needs to work everywhere.
You won't know until someone complains. Or you run SkillCheck.
We scanned 1,613 public skills across 8 repositories, including Microsoft and Anthropic's own collections.
1,613
skills scanned
65
average score out of 100
84%
missing proper descriptions
2%
scored Excellent
Last scanned: March 2026 with SkillCheck v3.12.0. Repos include:
| Category | Tier | What We Catch |
|---|---|---|
| Structure | Free | Missing fields, invalid names, broken YAML, XML injection, effort/maxTurns/disallowedTools validation |
| Body | Free | Content requirements, length, formatting, anti-pattern format lint, MCP tool qualification |
| Naming | Free | Conventions, specificity, reserved words, gerund naming |
| Semantics | Free | Contradictions, ambiguous instructions, wisdom/platitude detection, workflow-steps-in-description, description trigger style, railroading detection |
| Quality Patterns | Free | Examples, error handling, triggers, output format, structured instructions, prerequisites, gotchas sections |
| Anti-Slop | Pro | "Let's dive in", hedge words, filler phrases |
| Visual & WCAG | Pro | Color contrast, accessibility, visual design checks for skills that produce UI |
| Security | Pro | PII detection, credential safety, path traversal, Bash guardrail validation |
| Token Budget | Pro | Context efficiency, budget analysis, frontmatter overhead |
| Enterprise | Pro | Hardcoded paths, env config, audit support, metadata validation, setup/config handling, data storage path safety |
| Workflow | Pro | Exit criteria, unbounded iteration, deploy-without-verify, feedback loops. Based on the Trail of Bits anti-pattern catalog. |
| Agent Readiness | Pro | 28 checks across 6 pillars: reference integrity, eval readiness, orchestration safety, autonomy design, composability, observability. Maturity scoring from L0 (manual) to L3 (autonomous-ready). |
| Design Pattern | Free + Pro | Classifies skills into Reviewer, Generator, Inversion, Pipeline, or Tool Wrapper patterns (Google ADK taxonomy). Pro validates pattern-specific requirements. |
| Trigger Collision | Pro | Cross-skill directory scan detecting overlapping trigger phrases (Jaccard similarity) and artifact pipeline gaps (orphan producers, missing consumers). |
| Skill Discovery | Free + Pro | Scans your config files (CLAUDE.md, .cursorrules, .windsurfrules, AGENTS.md, hooks) for procedural knowledge that should be a skill. Free finds candidates. Pro generates the SKILL.md files. |
Claude reads a skill file and runs checks inline. No install, no binary.
A standalone binary that runs locally and connects to Claude Code as a tool server.
## my-awesome-skill Check Results [PRO]
### Critical Issues (1)
- Description missing WHEN clause. Add trigger context.
### Warnings (2)
- Line 47: Vague term "several" — specify a number
- No error handling documented
### Passed Checks: 77 / 82 applicable
### Pro Scores
✓ Anti-slop: 92/100
✓ WCAG AA: Pass
✓ Enterprise ready: Yes
✓ Agent Readiness: L2 Orchestratable (78/100)
Status: Needs Attention
Skills validated by SkillCheck get a public report page with scores, badges, and shareable links. Here are some top-scoring examples.
Reports coming soon.
Run skillcheck report your-skill/SKILL.md to generate your first report.
$0 forever
$79 lifetime
$49 /month
up to 10 users
effort field validation (low/medium/high)maxTurns field validation with runaway detectiondisallowedTools validation with overlap detectionopus, sonnet, haiku)skillcheck discover command for multi-platform config scanningskillcheck_discover MCP toolFull history on GitHub
No. SkillCheck is an independent project. The Free tier validates against the Agent Skills open standard (created by Anthropic). Pro adds extra quality checks like anti-slop detection, WCAG accessibility, and security scanning.
Built and tested for Claude Code. Since it follows the Agent Skills open standard and MCP protocol, it should work with other compatible tools like Cursor, VS Code, and Windsurf.
SkillCheck validates skill definitions, not MCP server implementations. Skills and MCP are complementary; MCP provides connectivity, skills provide procedural knowledge.
Pro and Team tiers will include GitHub Actions integration. Block PRs that introduce low-quality skills.
SkillCheck reports issues; you decide what to fix. Some checks are suggestions, not requirements.