Validate agent skills against the agentskills.io specification
Project description
skillscheck - a linter for SKILL.md files
A CLI tool that validates agent skill directories against the agentskills.io specification and checks compatibility with AI coding agents (Claude Code, Gemini CLI, Codex, Copilot, Cursor, Roo Code, Windsurf, Swival).
Installation / Usage
uvx skillscheck /path/to/skills-repo
Options
--format json: JSON output for CI pipelines--strict: treat warnings as errors (exit 1)--fix: auto-fix issues that have safe mechanical fixes (lowercase names, collapse consecutive hyphens, rename directories to match name field)--agents claude,gemini,codex,copilot,cursor,roo,windsurf,swival: run specific agent adapter checks (auto-detects if omitted, orall)--check spec,quality,disclosure,agents: run specific check categories
Check categories
spec: core specification compliance (frontmatter fields, naming, directory structure)quality: description quality, file hygiene, broken links, secret detectiondisclosure: progressive disclosure (reference file sizing, nesting depth)agents: agent-specific config validation (Claude plugin.json, Gemini extension.json, Codex openai.yaml, Copilot/Cursor/Roo/Windsurf/Swival conventions)
Exit codes
| Condition | Exit code |
|---|---|
| No errors | 0 |
| Errors found | 1 |
--strict with warnings |
1 |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
skillscheck-0.1.2.tar.gz
(66.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file skillscheck-0.1.2.tar.gz.
File metadata
- Download URL: skillscheck-0.1.2.tar.gz
- Upload date:
- Size: 66.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1395ca4ea1dc9f3191be2a78c0764fac77e5bffe31e881f50fb159006bbb03d0
|
|
| MD5 |
fb178560838d7765f7efeedb25dae2af
|
|
| BLAKE2b-256 |
613b921d3dac31fe157e3b644a95e165869fe3936cddcc2042b4423b12a80b3a
|
File details
Details for the file skillscheck-0.1.2-py3-none-any.whl.
File metadata
- Download URL: skillscheck-0.1.2-py3-none-any.whl
- Upload date:
- Size: 30.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e6135172ef30ae4b488e275747ffa7a8d9ea9d43583c3a685ad13e194d8e5c18
|
|
| MD5 |
479171ec21651637b4bb5cfa058d09e8
|
|
| BLAKE2b-256 |
4db89c8c89ce598a311875ba32adc921443b837c76c29d511bd2f71f725a380e
|
