| name | scaffold-notes |
| description | Maintains the agentic-utilities Pi package. Use when adding, documenting, inventorying, or refactoring Pi extensions, Agent Skills, prompt templates, or themes in this repository. |
Scaffold Notes
Use this skill when changing this repository's resource inventory.
Add an extension
- Create
extensions/<kebab-name>/index.ts.
- Export
default function (pi: ExtensionAPI).
- Document commands, tools, events, and dependencies in
extensions/<kebab-name>/README.md.
- Add an entry to
docs/catalog.md.
- Run
npm run check and pi -e ..
Add a skill
- Create
skills/<kebab-name>/SKILL.md.
- Ensure frontmatter
name matches the directory exactly.
- Write a description that says when to use the skill.
- Put long references under
references/ and helper code under scripts/ inside the skill directory.
- Add an entry to
docs/catalog.md.
- Run
npm run list and pi -e ..
Add prompts or themes
- Prompts:
prompts/<name>.prompt.md.
- Themes:
themes/<name>.json.
- Update
docs/catalog.md for anything intended for reuse.
Safety
Never commit secrets or local session state. Runtime dependencies belong in dependencies; Pi core packages belong in peerDependencies.
