Metadata-Version: 2.5
Name: skillseal
Version: 0.6.1
Summary: Lint, score, and routing-test Agent Skills (SKILL.md) before your agents do.
License: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: pydantic>=2.6
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# 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, so you catch that
before an agent does.

**Full docs: <https://pespinel.github.io/skillseal/>**

## Installation

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

One-off, no install:

```bash
uvx skillseal check ./skills
```

## Quickstart

```bash
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](https://pespinel.github.io/skillseal/commands/),
[`skillseal.yaml`/`skillseal.toml` config](https://pespinel.github.io/skillseal/configuration/),
and [CI integration](https://pespinel.github.io/skillseal/ci/) (GitHub Action,
pre-commit hook) on the docs site.

## Contributing

See [AGENTS.md](AGENTS.md) for setup, quality gates, and how to add a rule.
Planned work is tracked in [Issues](https://github.com/pespinel/skillseal/issues).

## License

[MIT](LICENSE)
