@skill-kit/registry

Local Skill registry and package manager for Skill Kit. Similar to npm for Node.js packages, this tool manages the installation, updating, and removal of Skills.

Features

• Install Skills from local paths, GitHub repositories, or remote registry
• List all installed Skills
• Update installed Skills to newer versions
• Remove Skills
• Version management with semver support
• Symlink mode for development

Installation

npm install @skill-kit/registry
# or
pnpm add @skill-kit/registry

CLI Usage

Install a Skill

# From local path
skill-registry install ./my-skill

# From GitHub
skill-registry install github:user/repo
skill-registry install github:user/[email protected]

# From registry
skill-registry install @user/skill-name
skill-registry install skill-name@^1.0.0

# Options
skill-registry install ./my-skill --link  # Create symlink
skill-registry install ./my-skill --force # Overwrite existing

List Installed Skills

skill-registry list
skill-registry list --json
skill-registry list --filter "pattern"

Update Skills

# Update all skills
skill-registry update

# Update specific skill
skill-registry update my-skill

# Update to specific version
skill-registry update my-skill --version 2.0.0

Check for Outdated Skills

skill-registry outdated

Uninstall a Skill

skill-registry uninstall my-skill
skill-registry rm my-skill

Programmatic API

import {
  installSkill,
  listSkills,
  updateSkill,
  uninstallSkill,
  checkOutdated,
} from '@skill-kit/registry';

// Install from local path
const result = await installSkill({
  target: './my-skill',
  link: false,
  force: false,
});

// List installed skills
const { skills, total } = await listSkills({
  filter: 'pattern',
});

// Update a skill
const updateResults = await updateSkill({
  name: 'my-skill',
  version: '2.0.0',
});

// Check for outdated skills
const outdated = await checkOutdated();

// Uninstall
const uninstallResult = await uninstallSkill({
  name: 'my-skill',
});

Storage Structure

Skills are stored in ~/.skill-kit/skills/ with metadata tracked in ~/.skill-kit/installed.json.

~/.skill-kit/
├── skills/
│   ├── my-skill/
│   │   └── SKILL.md
│   └── user__another-skill/
│       └── SKILL.md
├── installed.json
└── cache/

Install Sources

| Source | Example | Description | |--------|---------|-------------| | Local | ./my-skill | Install from local directory | | GitHub | github:user/repo | Install from GitHub repository | | GitHub URL | https://github.com/user/repo | Install from GitHub URL | | Registry | @user/skill | Install from Skill Hub registry | | Registry | [email protected] | Install specific version |

License

MIT