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)--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.0.tar.gz
(75.1 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.0.tar.gz.
File metadata
- Download URL: skillscheck-0.1.0.tar.gz
- Upload date:
- Size: 75.1 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 |
3be09db38a89dbb908478781b763e7b3ce97a54b2dd9e49eb99febe4ef40852a
|
|
| MD5 |
24dd68a464906d8f0c06c460b6d7d627
|
|
| BLAKE2b-256 |
0bbf8a950e1ddba5a681bd6d731ce51ab11f54b8918f8a43eff002fe7159f576
|
File details
Details for the file skillscheck-0.1.0-py3-none-any.whl.
File metadata
- Download URL: skillscheck-0.1.0-py3-none-any.whl
- Upload date:
- Size: 27.1 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 |
b6c14a08d845efce00912768835cebd71e0187416b5423454c246c77c19e64a4
|
|
| MD5 |
126d5ecabc6a260ec56055c86ff954fe
|
|
| BLAKE2b-256 |
5abe775f7766dbc2f1bbf394ef85527d45d79806e687ea8444fef32ae5911a55
|
