skilly 0.0.9

Load skills from dependencies.

skilly

Skill's management.

Installation

pip install skilly

Commands

cli

uvx skilly --help

GitHub-backed downloads

GitHub installs now use repository tarballs instead of recursively walking the contents API, which keeps GitHub API request counts low.

For higher GitHub rate limits, authenticate requests with either:

export SKILLY_GITHUB_TOKEN=ghp_your_token

or the standard GitHub environment variables:

export GITHUB_TOKEN=ghp_your_token
# or
export GH_TOKEN=ghp_your_token

You can also pass --github-token to GitHub-fetching commands such as skilly download, skilly skillsmp search, skilly skillsmp list, and skilly list.

When downloading from a repository URL that contains multiple skills, use --skill-name <name> to select one skill or --all to install every skill in that repository.

python

from pathlib import Path

from skilly import Skill, SkillRepository

generated = Skill(
    name="my-skill",
    description="Use when generating a skill in memory.",
    content="## Instructions\nDo the thing.\n",
)
saved = generated.install_to(Path("/tmp/skills"), skill_name="custom-folder-name")
# saved.path -> /tmp/skills/custom-folder-name

installed = Skill.from_dir(Path(".agents/skills/my-skill"))
github_skill = Skill.from_github(
    fetcher,
    "https://github.com/example/project/tree/main/.agents/skills/my-skill",
)

repository = SkillRepository()
for match in repository.scan_project():
    print(match.available.name, match.status)

Development

To see a list of useful commands run:

just

License

MIT