Metadata-Version: 2.4
Name: skilllint
Version: 0.1.1
Summary: Static analysis linter for Claude Code plugins, skills, and agents
Project-URL: Homepage, https://github.com/bitflight-devops/agentskills-linter
Project-URL: Issues, https://github.com/bitflight-devops/agentskills-linter/issues
Project-URL: Repository, https://github.com/bitflight-devops/agentskills-linter
Author-email: Jamie Nelson <jamie@bitflight.io>
Maintainer-email: Jamie Nelson <jamie@bitflight.io>
License: MIT
License-File: LICENSE
Keywords: agent,claude,claude-code,linter,plugin,skill,static-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: <3.15,>=3.11
Requires-Dist: gitpython>=3.1.45
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-frontmatter>=1.1.0
Requires-Dist: ruamel-yaml>=0.18.0
Requires-Dist: tiktoken>=0.8.0
Requires-Dist: typer>=0.21.0
Description-Content-Type: text/markdown

# skilllint

Static analysis linter for Claude Code plugins, skills, and agents.

## Installation

```bash
pip install skilllint
```

## Usage

```bash
skilllint path/to/plugin/
agentlint path/to/skill/SKILL.md
skillint path/to/plugin/plugin.json
```

## CLI entry points

All three commands are aliases for the same tool:

- `skilllint`
- `agentlint`
- `pluginlint`
- `skillint`

## Migration from PEP 723 scripts

Prior to v0.1, skilllint ran as a PEP 723 inline-dependency script:

```bash
# Old (deprecated) — no longer supported
uv run plugin_validator.py [files...]
```

With v0.1+, install the package and use the named CLI entry point:

```bash
# Install (choose one)
uv add skilllint          # add to project
uv tool install skilllint # install as global tool

# Run
skilllint [files...]      # primary entry point
agentlint [files...]      # alias
pluginlint [files...]     # alias
skillint [files...]       # alias
```

### Pre-commit hook migration

If you have a pre-commit hook referencing `plugin_validator.py`, update your
`.pre-commit-config.yaml` to use the published hook:

```yaml
repos:
  - repo: https://github.com/bitflight-devops/agentskills-linter
    rev: v0.1.0
    hooks:
      - id: skilllint
```
