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
Open-source Claude Code skill /unzuck curates social media feeds into dashboard
A free, open-source Claude Code skill called /unzuck scans feeds across Hacker News, Reddit, LinkedIn, YouTube, Twitter/X, Instagram, and Facebook in parallel using browser automation, scores items against user interest profiles, and generates interactive HTML dashboards.
AutoSkillUpdate: A Claude Code Plugin That Detects Outdated Skills
AutoSkillUpdate is an open-source Claude Code plugin that scans your codebase, compares it against existing skills, and identifies drift. It provides drift reports with file paths and line references, then offers to rewrite outdated skills with user confirmation.
Skillware adds synthetic data generator with entropy scoring for local model fine-tuning
Skillware has released a new synthetic data generator skill that uses zlib compression-ratio heuristics to score output diversity, helping prevent model collapse. The tool works out-of-the-box with Ollama, supports Gemini/Anthropic for high-reasoning batches, and outputs JSON batches for .jsonl fine-tuning pipelines.
Google PM Open-Sources Always On Memory Agent with SQLite Storage, No Vector DB
Google senior AI product manager Shubham Saboo has open-sourced an Always On Memory Agent that stores structured memories in SQLite instead of using vector databases, running on Gemini 3.1 Flash-Lite with scheduled memory consolidation every 30 minutes.