pac-pi-extension

Structure and refactor Pi extensions with dedicated directories and colocated tests.

2|1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/ladislas/mypac --skill pac-pi-extension
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pac-pi-extension
Source: https://github.com/ladislas/mypac/tree/main/skills/pac-pi-extension
Command: npx skills add https://github.com/ladislas/mypac --skill pac-pi-extension

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams plan, structure, and test Pi extensions safely to avoid unsafe top-level changes, ad-hoc wiring, and scattered responsibilities.

Core Features & Use Cases

  • Dedicated extension layouts: Use a dedicated directory for non-trivial extensions to keep code organized.
  • Co-located tests and helpers: Encourages tests and helper modules within the extension package.
  • Clear verification guidance: Aligns with npm test and npm run typecheck to ensure quality.
  • Use Case: When starting a new extension or refactoring an existing one, follow this skill to maintain maintainable architecture.

Quick Start

Load this skill when you are about to create, refactor, or reorganize a Pi extension.

Frequently Asked Questions about pac-pi-extension

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

FAQPage Schema
How do I structure Pi extensions to avoid unsafe top-level changes?

To structure Pi extensions safely, use a dedicated directory for non-trivial modules and colocate tests within the extension package. This prevents ad-hoc wiring and scattered responsibilities while maintaining a clean architecture.

What is the best way to refactor a Pi extension module structure?

The best way to refactor a Pi extension is to enforce a consistent layout checklist, ensuring dedicated directories and colocated helper modules. This maintains organization and prevents unsafe top-level modifications during reorganization.

How do I set up CI testing for Pi extensions?

Set up CI testing for Pi extensions by aligning verification with npm test and npm run typecheck. This ensures code quality and type safety before integrating structural changes or new module layouts.

Does Pi extension architecture require colocated tests and helpers?

Pi extension architecture strongly encourages colocated tests and helper modules within the extension package. This practice ensures clear verification guidance and maintains maintainable code organization for non-trivial extensions.

Why do I need a dedicated directory for non-trivial Pi extensions?

You need a dedicated directory for non-trivial Pi extensions to establish guardrails against unsafe top-level changes. This structural boundary keeps code organized and prevents scattered responsibilities across the project.