skill-installer

Lists and installs skills from GitHub repositories or local directories into Pi scopes.

2|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/yyy0107/pi-workbench --skill skill-installer-yyy0107
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/yyy0107/pi-workbench/tree/main/packages/agent-runtime/runtimes/pi/server/src/internal-skills/skill-installer
Command: npx skills add https://github.com/yyy0107/pi-workbench --skill skill-installer-yyy0107

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and installing agent skills from GitHub repositories or local directories involves manual cloning, path validation, and scope decisions. This Skill automates listing available skills and installing selected ones into the correct Pi user or project scope, including private repositories. ## Core Features & Use Cases - Skill Discovery: Lists candidate skills from GitHub repositories such as badlogic/pi-skills or openai/skills, with installed-status annotations. - Safe Installation: Downloads or sparse-checks-out selected skill directories with path validation, symlink checks, no-overwrite protection, and built-in resource safeguards. - Scope and Package Routing: Installs to user scope by default, supports project scope via --dest, and routes complete Pi packages to Pi's native package manager. - Use Case: A user asks to install the brave-search skill from the Pi Skills collection; the agent lists available skills, installs the selected directory into the user skills folder, validates it, and reports the result. ## Quick Start Ask the agent to list available skills from the Pi Skills repository and install the one you choose.

Frequently Asked Questions about skill-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a skill from a GitHub repository into Pi?▼

Run the install-skill-from-github.py script with --repo, --path, and optionally --ref or a GitHub URL. The script downloads an archive or falls back to a Git sparse checkout, validates the skill directory, and copies it into the Pi skills directory without overwriting existing skills.

How do I list available skills before installing?▼

Use list-skills.py with an optional --repo, --path, and --ref to enumerate candidate skill directories from a GitHub repository. It annotates entries already present in the destination skills directory and supports JSON output via --format json.

Can I install skills from private GitHub repositories?▼

Yes. Private repositories work through existing Git credentials, SSH keys, or the GITHUB_TOKEN/GH_TOKEN environment variables. The installer falls back from archive download to Git clone on HTTP 401, 403, or 404 responses, and tokens are never printed or placed in URLs.

What Python version is required to install skills?▼

The helper scripts require Python 3.10 or later and use only the standard library, so no extra packages are needed. Git is additionally required for the --method git mode and the private-repository fallback.

Why does skill installation fail with a destination exists error?▼

The installer refuses to overwrite an existing destination directory to protect current skills. For an explicit update, inspect local changes and compare the requested version in a temporary directory before applying an authorized update, rather than deleting the directory.

What is the difference between installing a skill and a Pi package?▼

A skill is a single directory with a SKILL.md file installed into a skills scope, while a Pi package is a complete npm, Git, or local package handled by Pi's native install flow. Complete packages should go through Pi's package manager rather than the skill installer scripts.