Metadata-Version: 2.5
Name: skillseal
Version: 0.8.0
Summary: Lint, score, and routing-test Agent Skills (SKILL.md) before your agents do.
Project-URL: Homepage, https://pespinel.github.io/skillseal/
Project-URL: Documentation, https://pespinel.github.io/skillseal/
Project-URL: Repository, https://github.com/pespinel/skillseal
Project-URL: Issues, https://github.com/pespinel/skillseal/issues
Project-URL: Changelog, https://github.com/pespinel/skillseal/releases
License: MIT
License-File: LICENSE
Keywords: agent-skills,agentskills,claude,cli,linter,skill-md
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
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

[![PyPI](https://img.shields.io/pypi/v/skillseal)](https://pypi.org/project/skillseal/)
[![CI](https://github.com/pespinel/skillseal/actions/workflows/ci.yml/badge.svg)](https://github.com/pespinel/skillseal/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

**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)
