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
CK Search: Local Semantic Search Tool with MCP Server Integration
CK Search is a local semantic search tool with a built-in MCP server that indexes any text directory without cloud dependencies. The tool can be used by AI agents via MCP, and the source provides a practical walkthrough covering setup, strengths, and limitations compared to grep.
OpenClaw User Critiques Tool's Architecture and Safety Gaps
A Reddit user describes OpenClaw as the only tool making agent automation this accessible but criticizes its architecture for lacking a control layer for file operations, a protected kernel, proper context management, and built-in versioning or tests.
DeepSeek Reasonix: Native Coding Agent with High Caching and Low Cost
Reasonix is a DeepSeek-native AI coding agent for the terminal, focusing on high caching efficiency and low inference cost.
Custom Output Styles Collection for Claude Code
A developer has created 13 custom output styles for Claude Code that modify the AI's behavior through system prompts. The styles include Roast for brutal code critique, Socratic for guided questioning, Breaker for adversarial testing, Ship It for pragmatic solutions, Paranoid for security focus, and TDD for test-driven development.