skillcheck: A linter for SKILL.md files that catches cross-agent compatibility issues
What skillcheck does
skillcheck is a linter for SKILL.md files that validates against the agentskills.io specification. It was created after encountering issues where skills written for Claude Code wouldn't load in VS Code due to mismatched name fields and other cross-agent compatibility problems.
Key features
- Scores description quality from 0-100 for discoverability (agents use this field to decide whether to activate a skill)
- Warns about fields that only work in Claude Code and won't work in VS Code, Codex, or Cursor
- Checks that file references in the SKILL.md body point to files that exist on disk
- Validates progressive disclosure token budgets from the spec
- Provides JSON output and exit codes for CI integration
- Includes a GitHub Action
Installation and usage
Install via pip: pip install skillcheck
Run it by pointing at a file or directory: skillcheck path/to/skill.md or skillcheck path/to/skills/directory
Technical details
- Built with Python 3.10+
- Only one dependency: PyYAML
- MIT licensed
- Built with assistance from Claude and VS Code
Comparison with existing tools
The creator read the source code of every existing validator before building skillcheck, including skills-ref, cclint, skills-cli, and Anthropic's quick_validate.py. The description scoring, cross-agent warnings, and file reference checks don't exist in any of these existing tools. Some frontmatter validation overlaps with existing validators.
📖 Read the full source: r/ClaudeAI
👀 See Also
How I built a 3D scroll website in 2 hours using Claude Code and Veo
A developer built a 3D scroll website in 2 hours using Claude Code, Veo video generation, and a custom 'video to website' skill. Full code and live demo shared.
Shipwright: An Open-Source Project Management Tool Built on Claude Code
Shipwright is an open-source project management tool that runs on Claude Code with 44 skills, 7 specialized agents, and 16 workflows. It includes binary quality gates and recovery playbooks, and was used to audit credential registries and evaluate automation platforms before engineering work began.
Claude Prototypes Real Estate Analysis App in 3 Hours Using Live Zillow Data via clawhub
A developer used Claude with the zillow-full clawhub tool to build a rental cash flow analysis app — pulling live Zillow API data, prototyping the UI around real JSON responses, and delivering a working prototype in one afternoon.
RUNE Protocol: Save AI Session Memory Across Platforms
RUNE (Relational User Notation for Entities) is an open-source protocol that saves your AI relationship to an encrypted .rune file, solving the cold-start problem where AI assistants forget you between sessions. Created with Claude Opus 4.6, it works across Claude and GPT platforms.