skill installer
- Repo stars 604
- Author repo VTCode
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @vinhnx · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · GitHub
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Env read
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Skill Installer
Helps install skills. By default these are from https://github.com/openai/skills/tree/main/skills/.curated, but users can also provide other locations.
Use the helper scripts based on the task:
- List curated skills when the user asks what is available, or if the user uses this skill without specifying what to do.
- Install from the curated list when the user provides a skill name.
- Install from another repo when the user provides a GitHub repo/path (including private repos).
Install skills with the helper scripts.
## Communication
- Start by confirming the task and running the appropriate command.
- If something fails, report the exact error and ask what to do next.
- Say only what is necessary.
## Scripts
### List Curated Skills
Show available skills from the curated list:
```bash
scripts/list-curated-skills.py
```
Optional: specify a different repo or path:
```bash
scripts/list-curated-skills.py --repo owner/repo --path skills/path --ref branch
```
Output formats:
- Default: numbered list with installation status
- JSON: `--format json` for programmatic use
### Install from Curated List
Install a skill by name from the curated list:
```bash
scripts/install-skill-from-github.py <skill-name>
```
The skill will be installed to `~/.agents/skills/<skill-name>/`.
### Install from Any GitHub Repo
Install skills from any GitHub repository:
```bash
scripts/install-skill-from-github.py owner/repo path/to/skill
```
For private repos, ensure `gh` CLI is authenticated or `GITHUB_TOKEN` is set.
Install multiple skills from the same repo:
```bash
scripts/install-skill-from-github.py owner/repo path/to/skill1 path/to/skill2
```
## Behavior and Options
### Installation Location
Skills are installed to `~/.agents/skills/` by default.
### Private Repositories
For private repositories:
1. Ensure GitHub CLI (`gh`) is installed and authenticated: `gh auth login`
2. Or set the `GITHUB_TOKEN` environment variable
### Overwriting Existing Skills
If a skill with the same name already exists, the installer will:
1. Warn about the existing skill
2. Ask for confirmation before overwriting
3. Back up the existing skill before replacement
### Validation
Before installing, the script validates:
- SKILL.md exists and has valid frontmatter
- Skill name follows naming conventions
- No invalid or dangerous file patterns
## Notes
- Skills installed from GitHub are placed in the User scope.
- After installation, the skill is immediately available in the current session.
- Use `/skills list` to verify installation.
- Use `/skills load <skill-name>` to activate the skill.
Sections and files
Listed in source order.
sections -> Communication → Scripts → List Curated Skills → Install from Curated List → Install from Any GitHub Repo → Behavior and Options
terms -> Helps install skills. · - List curated skills when the user asks what is available, or if the user uses this skill without specifying what to do. · Install skills with the helper scripts. · - Start by confirming the task and running the appropriate command. · The skill will be installed to ~/.agents/skills/<skill-name>/. · For private repos, ensure gh CLI is authenticated or GITHUBTOKEN is set. · Skills are installed to ~/.agents/skills/ by default. · 1. Ensure GitHub CLI (gh) is installed and authenticated: gh auth login 2.
files/cmd -> --format json · ~/.agents/skills/<skill-name>/ · GITHUB_TOKEN · ~/.agents/skills/ · gh auth login · /skills list · /skills load <skill-name>
body sha256 -> 952bad03bd6b
Communication
Start by confirming the task and running the appropriate command. If something fails, report the exact error and ask what to do next. Say only what is necessary.
List Curated Skills
Show available skills from the curated list: Optional: specify a different repo or path: Output formats: Default: numbered list with installation status JSON:
--format jsonfor programmatic useInstall from Curated List
Install a skill by name from the curated list: The skill will be installed to
~/.agents/skills/<skill-name>/.Install from Any GitHub Repo
Install skills from any GitHub repository: For private repos, ensure
ghCLI is authenticated orGITHUB_TOKENis set. Install multiple skills from the same repo:Installation Location
Skills are installed to
~/.agents/skills/by default.