Skip to main content

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

Development

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

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skillflag-0.1.0.tar.gz (34.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skillflag-0.1.0-py3-none-any.whl (24.2 kB view details)

Uploaded Python 3

File details

Details for the file skillflag-0.1.0.tar.gz.

File metadata

  • Download URL: skillflag-0.1.0.tar.gz
  • Upload date:
  • Size: 34.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for skillflag-0.1.0.tar.gz
Algorithm Hash digest
SHA256 1c84c7d294578f6d055b285ca448178e0c5f8c81d009c7bcf37f9cd343c9709c
MD5 ca8cb6d2cde7f17ba56c1fd1c99ad826
BLAKE2b-256 876af202dbbfe1deafbcadb98462cea1f01d278e9ba035def74c69f4f30c7744

See more details on using hashes here.

File details

Details for the file skillflag-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: skillflag-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 24.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for skillflag-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ab4e731e1cff5f64be7a5afd1feafd4bd1ab458060550498c482cbd4e5b47227
MD5 f7ac9d1ed3264606bde45e81c5a0f0a4
BLAKE2b-256 728358692296cca2e430db48213d49007057087b581a1956428f55da0944b2f8

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page