# Scaffold Notes

> Maintains the agentic-utilities Pi package. Use when adding, documenting, inventorying, or refactoring Pi extensions, Agent Skills, prompt templates, or themes in this repository.

- Skill: `aojdevstudio/scaffold-notes` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aojdevstudio/scaffold-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aojdevstudio/scaffold-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: aojdevstudio (https://skillmd.com/u/aojdevstudio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aojdevstudio/scaffold-notes

---


# Scaffold Notes

Use this skill when changing this repository's resource inventory.

## Add an extension

1. Create `extensions/<kebab-name>/index.ts`.
2. Export `default function (pi: ExtensionAPI)`.
3. Document commands, tools, events, and dependencies in `extensions/<kebab-name>/README.md`.
4. Add an entry to `docs/catalog.md`.
5. Run `npm run check` and `pi -e .`.

## Add a skill

1. Create `skills/<kebab-name>/SKILL.md`.
2. Ensure frontmatter `name` matches the directory exactly.
3. Write a description that says when to use the skill.
4. Put long references under `references/` and helper code under `scripts/` inside the skill directory.
5. Add an entry to `docs/catalog.md`.
6. 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`.