pi-package-creator

An Agent Skill for creating, refactoring, and validating real Pi packages.

It is built for one job:

• choose the right Pi package surface
• wire the package.json pi manifest correctly
• validate the package through the real pi install path

This is not a generic npm package helper. It is specifically for Pi packages.

What it ships

• SKILL.md - the main workflow
• references/surface-design.md - concrete Pi package surface guidance
• references/validation.md - install-path-first validation flow
• agents/openai.yaml - optional UI metadata

Install

The repository root is the skill directory. Keep the folder name pi-package-creator so the skill name matches its parent directory.

Codex

Clone or copy this repo to:

~/.codex/skills/pi-package-creator

Pi

Clone or copy this repo to one of:

~/.agents/skills/pi-package-creator
~/.pi/agent/skills/pi-package-creator

Or add the repo path to your Pi skills setting.

Use

Explicit invocation:

Use $pi-package-creator to scaffold or refactor a Pi package and validate it through pi install.

Typical tasks:

• create a new Pi package that adds one slash command
• refactor a Pi package to use the smallest correct surface
• fix a broken package.json pi manifest
• prove a Pi package works through the real install path

Notes

• The skill follows the Agent Skills format: https://agentskills.io/specification
• The validation flow is intentionally local-path-first. It treats pi install ./local/path as the release gate while a package is being built.
• Advanced Pi details should come from the installed Pi docs or pi --help, not from guessed paths.