pi-extension-template

Template for building Pi packages with extensions, Agent Skills, prompts, and themes.

Packages

Package details

extensionskillthemeprompt

Install pi-extension-template from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-extension-template
Package
pi-extension-template
Version
0.1.1
Published
Jun 1, 2026
Downloads
not available
Author
eiei114
License
MIT
Types
extension, skill, theme, prompt
Size
20 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

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

README

PACKAGE_DISPLAY_NAME

CI Publish npm version npm downloads License: MIT Pi package Trusted Publishing

One-line pitch for this TypeScript-first Pi package.

What this is

Briefly explain what this TypeScript-first package adds to Pi and who should use it.

Features

  • Feature 1
  • Feature 2
  • Feature 3

Install

Install the published npm package with Pi:

pi install npm:PACKAGE_NAME

Replace PACKAGE_NAME with the exact name from package.json. For a scoped npm package, keep the npm: prefix:

pi install npm:@your-scope/your-pi-package

Pin a specific version when you want reproducible installs:

pi install npm:PACKAGE_NAME@0.1.0

Install into the current project instead of your user Pi settings:

pi install npm:PACKAGE_NAME -l

Or install from GitHub:

pi install git:github.com/OWNER/REPO

Try it without permanently installing:

pi -e npm:PACKAGE_NAME

Quick start

Try this package locally:

pi -e .

Then run:

/your-command

Package contents

Path Purpose
extensions/ Pi TypeScript extension entrypoints (*.ts and index.ts)
lib/ Shared TypeScript helpers
skills/ Agent Skills
prompts/ Prompt templates
themes/ Pi themes
docs/ Release and setup docs

Development

npm install
npm run ci

Development flow

Use this default flow when building a new Pi extension OSS project from this template:

  1. Create the Vault project notes under 4_Project/<ProjectName>/.
  2. Add CONTEXT.md, README.md, ROADMAP.md, Docs/, Issues/, and Progress/.
  3. Write the PRD in 4_Project/<ProjectName>/Docs/.
  4. Split approved tracer-bullet issues into 4_Project/<ProjectName>/Issues/.
  5. Implement in the OSS repo.
  6. Run npm run ci, npm test, and npm pack --dry-run.
  7. Release with Trusted Publishing.
  8. Save release notes and follow-up decisions back to the Vault project.

Short version:

Vault notes -> PRD -> Issues -> implement -> ci/check -> release -> save learnings

Release

This package is set up for npm Trusted Publishing, so no NPM_TOKEN is required.

npm version patch
git push

See docs/release.md for setup details.

Template checklist

After creating a repository from this template, follow docs/template-checklist.md.

More docs:

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

For vulnerability reporting, see SECURITY.md.

Links

License

MIT\n