@pzzld/pi-shepherd

Shepherd pi skills and role resources.

Packages

Package details

skillprompt

Install @pzzld/pi-shepherd from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@pzzld/pi-shepherd
Package
@pzzld/pi-shepherd
Version
6.8.0
Published
Oct 8, 2026
Downloads
1,326/mo · 80/wk
Author
fl03
License
Apache-2.0
Types
skill, prompt
Size
187.8 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@pzzld/pi-shepherd

Pi content carrier: 22 native skills, nine prompt templates, nine role references, and the handoff template. /shepherd [arguments] explicitly loads orientation and routes actionable intent to /skill:spawn, preserving arguments. /skill:start is a deprecated compatibility redirect.

Pi discovers skills and prompts through the package.json pi key. Prompt frontmatter does not load skills. Prompts select the actual absolute available_skills locations, verify the Shepherd package identity, and resolve roles/resources from that package root; the project working directory is not a package origin. Seven agent definitions remain optional resources for a separately installed compatible dispatch extension; Pi does not natively register them through pi.subagents. Verify the extension's actual discovery, tools, persistent lifecycle, and communication before using Conductor lanes. No extension, broker, or team runtime is bundled or starts at session initialization. Missing dispatch is a capability limitation, not proof of a command collision.

Primary host references: prompt templates, packages. Live installed-host acceptance remains separate from carrier tests.

/skill:herd loads Shepherd's root profile; /skill:planting loads Planter's. /skill:workflow composes or resumes the lifecycle and /skill:spawn forwards a full run. These profiles stay in the current root session. The /shepherd prompt explicitly loads the generic shepherd information skill even though its root role reference points to herd.

Run bash scripts/gate.sh full from the source checkout to verify a fresh packed installation.