# Skill Installer

Install VT Code skills into ~/.agents/skills from a curated list or a GitHub repo path.

- Repository: https://github.com/vinhnx/VTCode (897 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add vinhnx/VTCode --skill skill-installer -g -a claude-code -y`
Codex: `npx skills add vinhnx/VTCode --skill skill-installer -g -a codex -y`
Cursor: `npx skills add vinhnx/VTCode --skill skill-installer -g -a cursor -y`
Gemini CLI: `npx skills add vinhnx/VTCode --skill skill-installer -g -a gemini-cli -y`

## Description

Install VT Code skills into ~/.agents/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo, including private repos.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/vinhnx/VTCode/blob/HEAD/crates/codegen/vtcode-skills/src/skills/assets/samples/skill-installer/SKILL.md