Install Agent Skills from GitHub repositories.
Note: This tool implements the agentskills.io specification. Your AI agent (Claude Code, Cursor, VS Code, etc.) likely already supports this spec natively and can discover skills automatically. This tool is primarily useful for:
- Installing skills from private repositories
- Batch installing multiple skills
- Managing skills across projects
-
Standalone
- macOS/Linux:
curl -fsSL https://raw.githubusercontent.com/trieloff/gh-upskill/main/install.sh | bash - Custom prefix:
curl -fsSL https://raw.githubusercontent.com/trieloff/gh-upskill/main/install.sh | bash -s -- --prefix ~/.local
- macOS/Linux:
-
GitHub CLI extension
gh extension install trieloff/gh-upskill- Then run via
gh upskill ...(or useupskilldirectly)
Skills are discovered by scanning for **/SKILL.md files per the agentskills.io spec.
List available skills:
upskill anthropics/skills --list
Install specific skills:
upskill anthropics/skills --skill pdf --skill xlsx
Install all skills:
upskill anthropics/skills --all
Use the -g or --global flag to install skills to ~/.skills instead of the project's .skills directory:
upskill -g anthropics/skills --skill pdf --skill xlsx
When installing globally:
- Skills are installed to
~/.skills .agents/discover-skillsandAGENTS.mdare not modified (since these are project-specific)
Use --dest-path to install skills to a custom location:
upskill anthropics/skills --skill pdf --dest-path .claude/skills
This is useful for compatibility with tools that expect skills in different locations (e.g., .claude/skills).
| Option | Description |
|---|---|
-g, --global |
Install to ~/.skills (personal skills) |
-b, --branch <ref> |
Branch, tag, or commit to clone |
--dest-path <path> |
Custom destination path (overrides -g) |
--list |
List available skills without installing |
--skill <name> |
Install specific skill(s) (repeatable) |
--all |
Install all discovered skills |
-i |
Add .skills/ to .gitignore |
-q, --quiet |
Reduce output |
- Clones the source repository to a temp directory
- Scans for all
**/SKILL.mdfiles (per agentskills.io spec) - Copies selected skill directories to
.skills/(or custom destination) - Creates
.agents/discover-skillshelper script - Updates
AGENTS.mdwith skills section (if source has one)
After installing, list available skills in your project:
./.agents/discover-skills
This scans both project skills (.skills/) and personal skills (~/.skills/), plus legacy .claude/skills locations for backwards compatibility.
- Lint:
make lint(shellcheck) - Test:
make test(network required forgh repo clone) - CI runs lint + tests on pushes/PRs to
main.
Part of the AI Ecoverse - tools for AI-assisted development:
- yolo - AI CLI launcher with worktree isolation
- ai-aligned-git - Git wrapper for safe AI commit practices
- ai-aligned-gh - GitHub CLI wrapper for proper AI attribution
- vibe-coded-badge-action - Badge showing AI-generated code percentage