What problem does it solve?
This Skill reduces friction and mistakes when designing and implementing Pi extensions by providing standards, patterns, and guardrails for tools, TUI components, commands, and event-driven behavior so extensions work reliably with agent calls and session branching.
Core Features & Use Cases
- Tool registration & prompts: Guidance on registering LLM-callable tools with promptSnippet and promptGuidelines and strict parameter schemas for reliable LLM usage.
- TUI & overlays: Patterns for building interactive overlays, widgets, and editor components that respect width, theming, keyboard input, and caching/invalidation rules.
- Concurrency & file safety: File mutation queue patterns, cancellation checks, and truncation utilities to prevent races and manage large outputs.
- State & session management: Store state in tool result details and reconstruct across session events to preserve branching correctness.
- Use Case: Scaffold a multi-file TypeScript extension that registers a search tool callable by the LLM, displays results in an overlay, and persists selection state across forks.
Quick Start
Scaffold a new extension that registers a tool with a promptSnippet and promptGuidelines, implements a renderResult overlay, and stores state in the tool result details.