pi-skill-hub

pi-skill-hub is a Pi extension for provenance-aware skill discovery, inventory, preview, and management. It keeps skill mutations preview-first so installs, adoptions, removals, and updates can be reviewed before they touch local files.

Capabilities

• Searches supported remote skill providers from inside Pi.
• Inventories local and external skill roots with provenance metadata.
• Opens a unified /skill-hub modal workspace with Browse, Inventory, Install, Update, Sources, and Remove panes.
• Uses terminal-size-aware modal sizing so the workspace expands on large terminals and stays bounded on small terminals.
• Builds explicit install, adopt, discovered source binding, manual source URL binding, update, refresh, and remove plans before applying changes.
• Requires confirmation tokens for every mutating flow.
• Writes debug logs only to the extension-local debug/ directory when debug is enabled.

Installation

npm package

pi install npm:pi-skill-hub

Git repository

pi install git:github.com/MasuRii/pi-skill-hub

Local extension folder

Place this folder in one of Pi's extension discovery paths:

~/.pi/agent/extensions/pi-skill-hub
.pi/extensions/pi-skill-hub

Usage

Open the unified modal workspace:

/skill-hub

The workspace contains internal panes for:

| Pane | Purpose | |---|---| | Browse | Search configured remote providers, preview remote SKILL.md content, and install after confirmation. | | Inventory | Inspect discovered local/external skills and start unmanaged-skill adoption. | | Install | Install directly by skill ID, skills.sh URL, GitHub URL, or provider reference. | | Update | Check/apply staged updates and refresh inventory drift/provenance status. | | Sources | Discover, bind, or auto-bind provider provenance for local skills. | | Remove | Remove clean managed local skills after preview and confirmation. |

Use ←/→ or Tab/Shift+Tab to move between panes, ↑/↓ to choose a pane action, Enter to run it, and Esc to close. Supplying legacy subcommand text after /skill-hub opens the modal workspace instead; feature flows now live inside the panes.

Mutating flows stay preview-only until their confirmation prompt is accepted with the generated token.

Configuration

Runtime configuration is stored at the extension root:

~/.pi/agent/extensions/pi-skill-hub/config.json

The package includes config/config.example.json as a starter template. Missing path settings default to:

| Setting | Default | |---|---| | localSkillRoot | ~/.pi/agent/skills | | externalSkillRoots | ~/.agents/skills | | updateStagingRoot | data/update-staging under the extension root |

Configuration options:

| Key | Type | Default | Purpose | |---|---|---:|---| | debug | boolean | false | Enables file-only debug logs under debug/debug.log. | | providers.skillsSh | boolean | true | Enables skills.sh provider search. | | providers.skillsMp | boolean | true | Enables Skills Marketplace provider search. | | maxSearchResults | number | 20 | Limits provider search results. | | requestTimeoutMs | number | 10000 | Bounds provider and remote preview requests. | | apiKeys.github | string | unset | Optional GitHub API key for source previews and update staging requests. | | apiKeys.skillsMp | string | unset | Optional SkillsMP API key for authenticated/AI provider search; SKILLSMP_API_KEY remains supported. | | localSkillRoot | string | home default | Overrides the managed local skill root. | | externalSkillRoots | string[] | home default | Adds read-only external inventory roots. | | updateStagingRoot | string | extension data default | Controls update staging location. |

Development

npm install
npm run build
npm run lint
npm run test
npm run check
npm run package:dry-run

The extension uses a root index.ts for Pi discovery and keeps implementation modules under src/.

Publishing

The package metadata follows the same publish-ready shape used by established Pi extensions:

• entrypoint: index.ts
• package exports: . → ./index.ts
• Pi extension manifest: pi.extensions
• published files: source, README, changelog, license, and config template
• runtime data/, debug/, dist/, and test artifacts excluded from npm publication

Related Pi Extensions

• pi-context-injector — Inject compact project context into first-turn and compaction prompts
• pi-agent-router — Active-agent routing and controlled subagent delegation
• pi-model-profiles — Save and apply reusable agent model profile snapshots
• pi-must-have-extension — RFC 2119 keyword normalization for prompt compliance

License

MIT