skill-installer

Files (3)

• SKILL.md
• install-skill.sh · scripts/
• list-skills.sh · scripts/

SKILL.md (first lines)

# Skill Installer

Install skills from GitHub repositories into `.grok/skills/`, persisted across sessions.

## Scripts

All scripts require network access. Use the bash tool to run them.

### List available skills from a GitHub repo

```bash
bash <this-skill-path>/scripts/list-skills.sh [--repo owner/repo] [--path skills-dir] [--ref branch]
```

Defaults: `--repo xai-org/skills --path skills/.curated --ref main`

### Install a skill from GitHub

```bash
bash <this-skill-path>/scripts/install-skill.sh --repo owner/repo --path path/to/skill [--ref branch]
```

Or from a full GitHub URL:

```bash
bash <this-skill-path>/scripts/install-skill.sh --url https://github.com/owner/repo/tree/main/path/to/skill
```

## Behavior

- Downloads the skill directory from GitHub via zip archive (public repos) or falls back to `git sparse-checkout` (private repos).
- Validates that the downloaded directory contains a `SKILL.md`.
- Aborts if the destination skill directory already exists.
- Installs to `.grok/skills/<skill-name>` (persisted across sessions).
- Supports `GITHUB_TOKEN` or `GH_TOKEN` environment variables for private repo access.

## Communication

When listing skills, output the list and ask which ones to install:

```
Available skills from owner/repo:
1. skill-one
2. skill-two (already installed)
Which ones would you like installed?
```

After installing, tell the user to start a new session to pick up the new skill.

From Matrixx0070/xclaw, MIT.

More from Matrixx0070/xclaw