pi-agent-resource

A PI package that installs an extension for creating, editing, deleting, and listing:

• Global agents in ~/.pi/agent/agents/<name>.md
• Project agents in .pi/agents/<name>.md when the local-agent flag is enabled
• Skills in ~/.pi/agent/skills/<name>/SKILL.md
• Local skills in .pi/skills/<name>/SKILL.md when the local-skill flag is enabled
• Global prompts in ~/.pi/agent/prompts/*.md
• Project prompts in .pi/prompts/*.md or grouped prompt directories when the local-prompt flag is enabled

What it does

The extension provides an interactive wizard that keeps prompting for the information it needs until the resource is ready.

It supports:

• creating agents
• creating Agent Skills spec compliant skills
• creating ungrouped prompts
• creating grouped prompts with _index.md and subcommands
• editing existing resources
• deleting existing resources
• listing current resources

Installed extension

The package exposes the extension from @extensions/resource-studio/index.ts.

Commands

• /resource-studio
• manage_project_resources custom tool

Scope flags

The extension now uses registered pi flags instead of inline command flags.

• local-agent → use project agents from .pi/agents
• local-skill → use project skills from .pi/skills
• local-prompt → use project prompts from .pi/prompts
• external-skill-editor → use the external editor for skill edits

When a local scope flag is enabled, the command shows a notice before it creates, edits, or deletes the local resource.

Prompt behavior

When creating a prompt, the wizard asks whether the prompt should be:

• ungrouped → .pi/prompts/<name>.md
• grouped → .pi/prompts/<group>/_index.md with one or more subcommands

Grouped prompts follow the _index.md + type: group layout used by grouped PI prompt sets.

Development mode

The repository uses a local .env file for development mode.

PI_RESOURCE_DEV=1

When that variable is set, the extension shows its development notice and uses the in-memory filesystem.

Tests

npm test