@carter-mcalister/pi-skillpacks

Session-scoped skill pack loader for Pi

Packages

Package details

extension

Install @carter-mcalister/pi-skillpacks from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@carter-mcalister/pi-skillpacks

Package: @carter-mcalister/pi-skillpacks
Version: 0.2.0
Published: May 10, 2026
Downloads: 45/mo · 7/wk
Author: carter-mcalister
License: MIT
Types: extension
Size: 54.6 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/skillpack-session-loader.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

`@carter-mcalister/pi-skillpacks`

A Pi package that adds /skillpacks, /skillpacks:install <owner/repo>, and /skillpacks:search <query> so you can browse, discover, install, and enable skill packs from ~/.pi/agent/skillpacks.

Install

Local development

mise install
bun install
bun test
bun run check
pi install /absolute/path/to/pi-packages/packages/pi-skillpacks

Install as a Pi package

pi install npm:@carter-mcalister/pi-skillpacks

Skill pack layout

~/.pi/agent/skillpacks/
  superpowers/
    agent-browser/
      SKILL.md
      templates/
    planner/
      SKILL.md

Skills are loaded from their original directories, so files next to SKILL.md keep working.

Global settings

Add skillpacks to ~/.pi/agent/settings.json to load skill packs automatically at startup:

{
  "skillpacks": [
    "superpowers",
    "helpers/reviewer",
    {
      "path": "helpers",
      "skills": ["planner", "writer"]
    }
  ]
}

Entries use the same format as profile skillpacks: strings load an entire skillpack path, and objects with path plus skills load selected nested skills.

Commands

/skillpacks
/skillpacks:install obra/superpowers
/skillpacks:search planner

/skillpacks opens an interactive browser with search, per-skillpack/per-skill toggles on spacebar, Enter and left/right collapse/expand for sections, Esc to apply changes, Ctrl+C to cancel, and a detail pane for the currently selected row.

/skillpacks:install installs every discovered skill from a GitHub repository into a single local skillpack directory such as ~/.pi/agent/skillpacks/obra-superpowers, enables that skillpack for the current session, and reloads Pi with polished progress updates while the install is running.

/skillpacks:search runs gh skill search --json ..., shows matching repositories in the Pi UI, lets you choose one, and then installs and enables that repository as a local skillpack.

Selections persist in the current session history. Overlapping selections use union semantics, so removing a nested path will not unload a skill that is still covered by a parent selection.