Skill Kits

Shareable skill bundles for rapid installation

Overview

Skill kits are shareable .skani.json files that allow you to rapidly install a curated set of skills. Instead of installing skills individually, you can share kits with your team to bootstrap development environments consistently.

Kits use the same format as skani.json, but are saved with a .skani.json extension to distinguish them as sharable bundles.

Creating a Kit

To create a skill kit, simply copy your existing skani.json file to a new file with a .skani.json extension:

➜~cp skani.json my-kit.skani.json

Share the .skani.json file with your team or include it in your project repository.

Installing a Kit

Use the kit install command to install skills from a kit:

kit list

skani kit list

List all available kits in current directory.

➜~skani kit list

kit install

skani kit install <name> [--replace]

Install skills from a kit file. Use --replace to clear existing skills first.

➜~skani kit install superpowers --replace

kit restore

skani kit restore

Restore skani.json from most recent backup created by kit install.

➜~skani kit restore

Installation Modes

The kit install command supports two installation modes:

Merge Mode (Default)

Installs kit skills alongside existing ones. Skills with the same ID are skipped to prevent duplicates.

➜~skani kit install my-kit

Replace Mode

Clears all existing skills, backs up your skani.json to previous.skani.json, then installs the kit. Use this for a clean slate.

➜~skani kit install my-kit --replace

Backup & Restore

When using replace mode, your current skani.json is automatically backed up to previous.skani.json. You can restore your previous setup at any time:

➜~skani kit restore

Note: Restore only works if a backup exists from a previous kit install with --replace.

Example Kit

Here's an example of what a .skani.json kit file looks like:

{
  "version": "1.0.0",
  "environment": {
    "name": "my-project",
    "created": "2026-02-15T00:00:00.000Z",
    "updated": "2026-02-15T00:00:00.000Z"
  },
  "skills": [
    {
      "id": "owner-repo-skill-name",
      "name": "skill-name",
      "version": "main",
      "source": {
        "url": "https://github.com/owner/repo/tree/main/skills/skill-name",
        "type": "github",
        "owner": "owner",
        "repo": "repo",
        "ref": "main",
        "path": "skills/skill-name"
      },
      "installedAt": "2026-02-15T00:00:00.000Z"
    }
  ]
}

CLI Commands

skani.json →