pi-create

Opinionated project scaffolder for pi.dev extensions with full pipeline integration.

Installation

pi install npm:pi-create

What It Does

pi-create scaffolds new pi.dev extension projects with pipeline tools pre-wired. It fills the gap where pi-extension-toolkit provides bare structural scaffolding only — pi-create adds pipeline integration (commit-lint, changelog, CI, release, readme, env-guard) out of the box.

Template Variants

| Variant | Description | ~LOC | |---------|-------------|------| | tool | Single-tool extension (minimal) | 150 | | command | Command-only extension (no tools) | 100 | | skill | Full skill package (tools + commands) | 300 | | full | Complete package with all pipeline tools pre-wired | 450 |

Tools

scaffold_project

Create a new pi.dev extension project from a template variant.

Parameters:

• name (string, required) — Project name (e.g. "pi-my-tool")
• description (string, required) — Short description
• variant (enum: tool|command|skill|full, required) — Template variant
• features (string[], optional) — Features to include

Example:

Use scaffold_project with name="pi-greet", description="A greeting extension", variant="tool"

scaffold_add

Add components to an existing scaffolded project.

Parameters:

• component (enum: tool|command|skill|test|ci|readme, required) — Component type
• name (string, required) — Name for the new component

Example:

Use scaffold_add with component="tool", name="fetch_data"

scaffold_validate

Validate a scaffolded pi.dev project.

Parameters:

• projectPath (string, optional) — Path to project (defaults to cwd)

Example:

Use scaffold_validate to check if the project is correctly scaffolded

Pipeline Tools Pre-wired (full variant)

• pi-commit-lint — Conventional commit enforcement
• pi-changelog — Changelog generation
• pi-ci — GitHub Actions workflow
• pi-release — Release automation
• pi-readme — README template
• pi-env-guard — Environment validation

Resources

• npm
• GitHub
• pi.dev

License

MIT