iagent-skills-hub
Requires Python 3.11 or newer. The CLI uses only the Python standard library at runtime.
Install from this repository:
python3.11 -m pip install ./cli
iagent-skills-hub --help
Or run without installing:
python3.11 skills/iagent-skills-hub/scripts/iagent_skills_hub.py --help
The skill's script is the CLI's source of truth. Builds include it in the Python package, so the installed iagent-skills-hub command and the skill use the same implementation.
The default API is https://skillshub.kiwilightyear.com/api/v1. Set IAGENT_SKILLS_HUB_API_BASE or pass --api-base before the command to use another API. Protected commands use a magic-campus access token from IAGENT_SKILLS_HUB_TOKEN or --token. The previous MUSHROOM_HUB_* environment variables also work. The backend accepts the token in Authorization: Bearer ...; a browser GitHub session cookie cannot be used as a CLI token.
export IAGENT_SKILLS_HUB_API_BASE=http://127.0.0.1:8000/api/v1
export IAGENT_SKILLS_HUB_TOKEN=<your-magic-campus-access-token>
iagent-skills-hub list --query markdown --sort-by stars
iagent-skills-hub info example-skill
iagent-skills-hub files example-skill
iagent-skills-hub versions example-skill
iagent-skills-hub cat example-skill SKILL.md
iagent-skills-hub download example-skill --version 1.0.0 --output example.zip
iagent-skills-hub install example-skill
iagent-skills-hub install example-skill --dir ./skills/example-skill --force
iagent-skills-hub uninstall example-skill
iagent-skills-hub publish example-skill --dir ./my-skill --name "Example Skill" \
--version 1.0.0 --changelog "Initial release" --tag tools
iagent-skills-hub edit example-skill --dir ./my-skill --name "Example Skill" \
--version 1.1.0 --changelog "Add examples"
iagent-skills-hub edit example-skill --name "Example Skill" \
--version 1.1.0 --changelog "Update metadata"
iagent-skills-hub edit example-skill --new-slug renamed-skill --name "Example Skill" \
--version 1.1.0 --changelog "Rename slug"
iagent-skills-hub delete example-skill
iagent-skills-hub stars example-skill
iagent-skills-hub star example-skill
iagent-skills-hub unstar example-skill
iagent-skills-hub starred
iagent-skills-hub comments example-skill
iagent-skills-hub comment example-skill "Helpful skill"
publish uploads every file below --dir through the backend's presigned URL API, then publishes the manifest. edit with --dir replaces the version's file set; omitting --dir keeps the existing files. The directory must contain a nonempty SKILL.md. install extracts an archive under ~/.iagent/skills/<slug> by default and refuses to replace an existing directory unless --force is given. uninstall uses the same default path.
Run tests with PYTHONPATH=cli python3.11 -m unittest discover -s cli/tests -v from the repository root.
Publish to the internal Python package registry
To publish directly from your machine, use the local script from the repository root (it also works from another directory):
./cli/publish-internal.sh --dry-run
./cli/publish-internal.sh
The script needs uv, runs the CLI tests, builds an isolated wheel and source archive, checks them with Twine, and then uploads them to the internal registry. Twine prompts for the internal account password unless TWINE_PASSWORD is already set. Change version in cli/pyproject.toml before publishing a new release.
The GitHub Actions workflow .github/workflows/publish-python-cli-to-internal-pypi.yml builds, tests, checks, and uploads the package to https://pypi.kiwilightyear.com/internal/prod/ when a tag such as iagent-skills-hub-v0.1.1 is pushed. The tag version must match cli/pyproject.toml. Increment the version for each new release.
Before releasing, create a GitHub environment named internal-pypi and add its secret INTERNAL_PYPI_PASSWORD with the password for the internal account. The workflow passes that account and secret separately to the upload action; do not put credentials in the repository URL. The runner must be able to reach the internal registry.
For installation after release, use the registry's Simple API index URL with pip or uv. That URL may differ from the upload endpoint above; get the install URL and read credentials from your registry administrator. Keep credentials out of the command history where possible.
After merging the package and workflow, publish a matching tag:
git tag iagent-skills-hub-v0.1.1
git push origin iagent-skills-hub-v0.1.1
Publish to public PyPI from your machine
Use a PyPI API token for the iagent-skills-hub project. For the first release, the token needs permission to create the project. The script prompts for the token unless TWINE_PASSWORD is set; do not put it in the repository or a command-line argument.
./cli/publish-pypi.sh --dry-run
./cli/publish-pypi.sh
This uploads to https://upload.pypi.org/legacy/ with username __token__. After publishing, install with python3.11 -m pip install iagent-skills-hub. Increment cli/pyproject.toml's version before publishing another release.
Metadata
Release files for iagent-skills-hub 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iagent_skills_hub-0.1.1.tar.gz | 9.4 kB | Without provenance | Details for iagent_skills_hub-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iagent_skills_hub-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for iagent_skills_hub-0.1.1-py3-none-any.whl |
Total release size: 17.2 kB
Release files / iagent_skills_hub-0.1.1.tar.gz
| Download URL | iagent_skills_hub-0.1.1.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8b32e1295588d9607f62369678db2c1c747e541681dffe47807d4498c41fa906
|
|
BLAKE2b-256 checksum How to use checksums |
e92c16f0bec04a476c4e9c5b7bb3ed0a9e397b3c6fffd1bc926954f501b708b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / iagent_skills_hub-0.1.1-py3-none-any.whl
| Download URL | iagent_skills_hub-0.1.1-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
997a5d1cf28e962beb4407f4de41bb525e7e802aef62cb20180f14c10af60ceb
|
|
BLAKE2b-256 checksum How to use checksums |
6a8485295b26d531b03868794e70cc5a8d3689645ed5260948895e349014929e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Security for iagent-skills-hub 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.