skillflag (Python)

Python implementation of the Skillflag convention: a minimal CLI interface for bundling, listing, and installing agent skills 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

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

Embed in your CLI

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:

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

Documentation

• Skillflag specification
• Integration guide

Development

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

License

MIT