SkillSeal

Test your Agent Skills before your agents do.

SKILL.md files can be syntactically valid and still be bad: a vague description that never routes correctly, an oversized file that eats context, a curl | sh buried in a code block, a hardcoded /Users/you/... path that only works on your machine. SkillSeal is a local-first, offline-first CLI that lints, scores, and routing-tests SKILL.md files — catching what a manual read-through misses, before an agent does.

skillseal check output: two WARNs, a FAIL on rm-rf, a WARN on an absolute path, score 86/100

What it catches

Category	Catches things like
Specification	Invalid frontmatter, a `name` that doesn't match its directory
Quality	Vague descriptions, oversized files, dangling file references
Security	`rm -rf` / `curl \| sh` in a code block, secret-file reads
Portability	Hardcoded `/Users/you/...` paths, OS-specific commands

Full docs: https://pespinel.github.io/skillseal/

Installation

uv tool install skillseal
# or: pipx install skillseal
# or: pip install skillseal

One-off, no install:

uvx skillseal check ./skills

Quickstart

skillseal check ./skills          # lint: spec, quality, security, portability
skillseal test ./skills           # routing tests (skillseal.yaml)
skillseal conflicts ./skills      # duplicate names / routing overlap between skills
skillseal diff old/ new/          # score delta between two versions of a skill

See the full command reference, skillseal.yaml/skillseal.toml config, and CI integration (GitHub Action, pre-commit hook) on the docs site.

Contributing

See AGENTS.md for setup, quality gates, and how to add a rule. Planned work is tracked in Issues.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skillseal-0.12.0.tar.gz (213.7 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

skillseal-0.12.0-py3-none-any.whl (38.4 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file skillseal-0.12.0.tar.gz.

File metadata

Download URL: skillseal-0.12.0.tar.gz
Upload date: Aug 26, 2026
Size: 213.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for skillseal-0.12.0.tar.gz
Algorithm	Hash digest
SHA256	`99c5c32e268923e392ea4d9f8253332070a110f7361541e069e2a12867e5c904`
MD5	`50af3376a60cfd9fe5183e803449b61b`
BLAKE2b-256	`24c5bb1d1522974df2437687fad928279369de1d96c16d162b00d091b8b4887d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for skillseal-0.12.0.tar.gz:

Publisher: release.yml on pespinel/SkillSeal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: skillseal-0.12.0.tar.gz
- Subject digest: 99c5c32e268923e392ea4d9f8253332070a110f7361541e069e2a12867e5c904
- Sigstore transparency entry: 2606256359
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: pespinel/SkillSeal@781c5fca140361e826f2aba73ef069b7f2d78673
- Branch / Tag: refs/heads/main
- Owner: https://github.com/pespinel
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@781c5fca140361e826f2aba73ef069b7f2d78673
- Trigger Event: workflow_dispatch