Ship better skills.
Catch issues before your users do.

SkillCheck validates your Agent Skills against the open standard. Pro adds accessibility, security, and anti-slop checks. Built for Claude Code.

Check My Skill View on GitHub

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.

What's New in v3.15.0

Design Pattern Classification (Free)

  • + Classifies skills as Reviewer, Generator, Inversion, Pipeline, or Tool Wrapper
  • + Based on Google ADK taxonomy for agent design patterns

Pro: Pattern, Artifact, and Collision Checks

  • + Pattern-specific deep checks per design pattern type
  • + Artifact contract validation for produces/consumes frontmatter
  • + Trigger collision detection across skill directories
  • + 105 checks across 20 categories

Full changelog · Free tier on GitHub

You built a skill. But is it good?

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.

Tested at scale

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

What It Checks

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.

How It Works

Free

Claude reads a skill file and runs checks inline. No install, no binary.

1 Copy skill-check folder to ~/.claude/skills/
2 Say "skillcheck my skill" in Claude Code
3 Get instant feedback

Pro

A standalone binary that runs locally and connects to Claude Code as a tool server.

1 Download binary from purchase email
2 Add to ~/.claude.json with license key
3 All Pro checks unlocked automatically
## 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

Validated Skills

Browse all

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.

Pricing

Free

$0 forever

  • ✓ Structure validation
  • ✓ Body & naming checks
  • ✓ Semantic consistency
  • ✓ Quality patterns (strengths)
  • ✓ No install needed
  • ✓ Open source (MIT)
Get Started

Pro

$79 lifetime

  • ✓ Everything in Free
  • ✓ Anti-slop detection
  • ✓ Security scanning
  • ✓ Token budget analysis
  • ✓ WCAG accessibility
  • ✓ Enterprise readiness
  • ✓ Agent Readiness (L0-L3)
  • ✓ Advanced quality analysis
  • ✓ Go binary & MCP server
Get Pro
COMING SOON

Team

$49 /month

up to 10 users

  • ✓ Everything in Pro
  • ✓ Custom rulesets
  • ✓ Team dashboard
  • ✓ CI/CD integration

Changelog

v3.15.0 — March 2026

  • New (Free): Design Pattern Classification; detects Reviewer, Generator, Inversion, Pipeline, Tool Wrapper patterns
  • New (Pro): Pattern-specific deep checks; validates criteria, output specs, question frameworks, stage docs per pattern
  • New (Pro): Artifact Contract Validation; checks produces/consumes frontmatter with metadata and discovery docs
  • New (Pro): Trigger Collision Detection; cross-skill directory scan for overlapping triggers and artifact pipeline gaps
  • 105 total checks across 20 categories

v3.14.0 — March 2026

  • New (Free): description trigger style check (summary vs trigger condition)
  • New (Free): railroading detection (over-prescriptive language)
  • New (Free): gotchas section recognized as quality strength
  • New (Pro): setup/config handling check (missing-config fallback)
  • New (Pro): data storage path safety (skill-dir persistence warning)
  • 87 total checks across 18 categories

v3.13.0 — March 2026

  • New: effort field validation (low/medium/high)
  • New: maxTurns field validation with runaway detection
  • New: disallowedTools validation with overlap detection
  • Updated: model field now accepts aliases (opus, sonnet, haiku)
  • Spec version updated to 2026-03-20

v3.12.0 — March 2026

  • New: skillcheck discover command for multi-platform config scanning
  • Scans Claude Code, Cursor, Windsurf, Codex CLI configurations
  • Pro: auto-generates SKILL.md files from discovered candidates
  • New: skillcheck_discover MCP tool

v3.11.0 — March 2026

  • 18 check categories across free and pro tiers
  • 82 total checks (now 105 in v3.15.0)

v3.10.0 — March 2026

  • New: Agent Readiness validation (L0-L3 maturity scoring)
  • Orchestration safety, composability, observability, autonomy design checks

Full history on GitHub

FAQ

Is this official Anthropic tooling?

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.

What platforms does it work with?

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.

What about MCP servers?

SkillCheck validates skill definitions, not MCP server implementations. Skills and MCP are complementary; MCP provides connectivity, skills provide procedural knowledge.

Can I use it in CI/CD?

Pro and Team tiers will include GitHub Actions integration. Block PRs that introduce low-quality skills.

What if I disagree with a check?

SkillCheck reports issues; you decide what to fix. Some checks are suggestions, not requirements.

Ready to ship better skills?