skills.rest
Immac
ImmacCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

deterministic-bootstrap

Builds, self-installs, and verifies the extension-creator as a pi-discoverable extension via one script.

Updated May 1, 2026
Search Tags:#automation#typescript#build#setup#bootstrap#install#pi extension
One-click install
npx skills add https://github.com/Immac/pi-extension-builder --skill deterministic-bootstrap-immac
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deterministic-bootstrap
Source: https://github.com/Immac/pi-extension-builder/tree/main/.pi/skills/deterministic-bootstrap
Command: npx skills add https://github.com/Immac/pi-extension-builder --skill deterministic-bootstrap-immac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the extension-creator after a fresh clone or git pull requires multiple manual steps — building TypeScript, installing into the vault, cleaning stale directories, and verifying the registry — which is error-prone when done by hand. ## Core Features & Use Cases - Single-command bootstrap: Runs clean, build, self-install into ~/.extension-manager/extensions/pi-extension-creator/, registry sync, and stale-directory cleanup in one script. - Verification with exit codes: Confirms the vault exists, the registry has exactly one enabled entry, and pi's settings.json points to the vault, returning distinct exit codes (0-3) for each failure stage. - Use Case: After cloning the repository or pulling updated source files, run the bootstrap to rebuild and reinstall the extension so the vault dist matches src, then reload pi to activate it. ## Quick Start Ask the assistant to bootstrap this repo, which runs npm run bootstrap to build, install, and verify the extension-creator in one step.

Frequently Asked Questions about deterministic-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap the pi extension-creator after cloning the repo?▼

Run npm run bootstrap from the repository root, or execute bash scripts/bootstrap.sh directly. The script cleans dist, builds with tsc, self-installs into the vault, and verifies the installation automatically.

When should I re-run the extension-creator bootstrap script?▼

Re-run it on a fresh clone needing first-time setup, after a git pull that updates source files, or when the installed vault dist no longer matches the current src. It rebuilds and reinstalls everything deterministically.

What do the bootstrap script exit codes mean?▼

Exit code 0 means bootstrap verified successfully. Code 1 indicates a build or validation failure, code 2 is reserved for install failures, and code 3 means the post-install verification checks failed.

Why is my pi extension not active after running bootstrap?▼

The bootstrap installs files and syncs settings.json, but running pi sessions do not pick up changes automatically. You must run /reload in pi after bootstrap completes to activate the extension.

Does the bootstrap script clean up old extension installations?▼

Yes, it removes the stale pre-vault directory at ~/.pi-extensions/pi-extension-creator/ and verifies that no stale directory remains. It also confirms the registry contains exactly one enabled entry pointing to the vault.

Related Skills

Explore More Software Engineering Skills→
ssu96ldssu96ld

magnus-setup

Bootstrap the Magnus Consulting website repository and install dependencies via npm.

Community
Advanced
davidorexdavidorex
25

pi-project-workflows

Install a meta-package re-exporting pi-project, pi-workflows, and pi-behavior-monitors.

Community
Intermediate
DexploarerDexploarer
7

plugin-builder

Scaffold ElizaOS plugins with TypeScript, tests, and documentation.

Community
Intermediate
Agent-ClubhouseAgent-Clubhouse
2

install-local

Build a plugin and install it into the local Clubhouse plugins directory.

Official
Intermediate