Skip to content
Conduit

skill

skillup

A minimal, user-friendly Python CLI to manage agent skills from GitHub releases or branches

bmsuisse/skillupcommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/bmsuisse/skillup itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 17, 2026

Features

  • Interactive install — pick skills from any GitHub repo release
  • Multi-repo — manage skills from multiple sources independently
  • Lock file — pins commit SHAs for reproducible installs (~/.agents/skills.lock.json)
  • Auto-update — upgrade all or specific repos to their latest release or branch head
  • Smart cache — skips redundant downloads; override with SKILLUP_CACHE_DIR
  • gh integration — uses gh CLI when available, falls back to requests
  • Azure DevOps — install skills from private Azure DevOps Git repos via DefaultAzureCredential or a PAT

Installation

uv tool install skillup

To use Azure DevOps sources, install the azure extra:

uv tool install 'skillup[azure]'

Usage

Add skills from GitHub

skillup add google/gemini-cli-skills

No releases? Falls back to main automatically. Pin a branch or add specific skills non-interactively:

skillup add anthropics/skills --branch main --skill pdf

Full GitHub URLs are also accepted:

skillup add https://github.com/anthropics/skills

Add skills from Azure DevOps

Pass the full Azure DevOps clone URL — the provider is detected automatically from the domain:

skillup add https://dev.azure.com/myorg/myproject/_git/myrepo
skillup add https://myorg.visualstudio.com/myproject/_git/myrepo   # legacy URL format

# pin a branch or add specific skills non-interactively
skillup add https://dev.azure.com/myorg/myproject/_git/myrepo --branch develop --skill my-skill

Azure DevOps repos are stored in the lock file under the key azdo:org/project/repo and participate in the shared update and sync commands just like GitHub repos.

Authentication

Authentication is resolved in this order:

  1. AZURE_DEVOPS_TOKEN env var — a Personal Access Token (PAT) with Code → Read scope, or any valid bearer token.
  2. DefaultAzureCredential (requires the azure extra) — tries, in order: environment variables (AZURE_CLIENT_ID / AZURE_CLIENT_SECRET / AZURE_TENANT_ID), workload identity, managed identity, Azure CLI (az login), Azure Developer CLI, and interactive browser login.

The recommended approach for developer machines is DefaultAzureCredential via az login:

uv tool install 'skillup[azure]'
az login
skillup add https://dev.azure.com/myorg/myproject/_git/myrepo

Remove skills

skillup remove

Update skills

skillup update                              # all repos
skillup update --repo google/gemini-cli-skills  # one repo

Sync (restore from lock file)

skillup sync

Installs skills at the exact pinned SHAs from the lock file — useful for new machines.

Migrate from NPX skills CLI

skillup migrate                       # reads skills-lock.json from repo root
skillup migrate path/to/skills-lock.json

Skill definition

A folder is recognized as a skill when it lives inside a skills/ directory at the repo root and contains a SKILL.md file.

Development

uv sync          # install deps
uv run skillup --help
uv run pytest
uv run pyright skillup

License

MIT

↑↓ navigate openesc close