Metadata-Version: 2.4
Name: skillflag
Version: 0.1.0
Summary: Skillflag producer CLI and skill-install companion (Python port)
Project-URL: Homepage, https://github.com/osolmaz/skillflag
Project-URL: Repository, https://github.com/osolmaz/skillflag
Author: Onur Solmaz
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# skillflag (Python)

Python implementation of the [Skillflag](https://github.com/osolmaz/skillflag) convention: a minimal CLI interface for bundling, listing, and installing [agent skills](https://agentskills.io) without a third-party registry.

This package ships:

- the embeddable producer library (`skillflag.maybe_handle_skillflag`, `skillflag.find_skills_root`),
- the standalone `skillflag` binary,
- the `skill-install` adaptor that installs exported skills into agent tools (Claude Code, Codex, Amp, Goose, and others).

Exports are byte-identical to the other Skillflag implementations (TypeScript, Go, Rust) — any producer can be paired with any installer.

## Install

```bash
uv tool install skillflag
# or run one-off
uvx skillflag list
```

## Embed in your CLI

```python
import sys

from skillflag import SkillflagOptions, find_skills_root, maybe_handle_skillflag

maybe_handle_skillflag(
    sys.argv,
    SkillflagOptions(skills_root=find_skills_root(__file__)),
)
```

Then ship a `skills/<skill-id>/SKILL.md` directory in your package. Users install your skill with:

```bash
your-tool --skill export <id> | skill-install --agent claude --scope repo
```

## Documentation

- [Skillflag specification](https://github.com/osolmaz/skillflag/blob/main/docs/SKILLFLAG_SPEC.md)
- [Integration guide](https://github.com/osolmaz/skillflag/blob/main/docs/INTEGRATION.md)

## Development

```bash
cd python
uv sync
uv run ruff format --check . && uv run ruff check . && uv run pytest
```

## License

[MIT](https://github.com/osolmaz/skillflag/blob/main/LICENSE)
