extension-designer

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.