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