Imported from artmsilva/agent-tools (packages/pi-vibes/AGENTS.md). Install upstream with npx skills add artmsilva/agent-tools --skill pi-vibes. Copyright stays with the author.

Package instructions

Name: pi-vibes
Author: artmsilva

Scope

Pi extension: ambient soundtrack, mood ring, and familiar footer status driven off a shared rolling window of tool events.

Validation

npm test

Guardrails

Mood and familiar share one footer status key (ctx.ui.setStatus("vibes", ...)) — pi's footer shows all status keys together, so don't split them.
Sound spawns must stay { detached: true, stdio: "ignore" } + .unref(), and the animation timer must stay setInterval(...).unref() — neither may keep the process alive.
updateLastStatus() swallows a stale-ctx throw and drops lastCtx rather than rethrowing — a queued timer can outlive its session on reload.
Settings persist in ~/.pi/agent/vibes.json; changing the shape needs a migration path in settings.ts, not a silent break.
Debounce sound to max 1 per 2 seconds — don't remove this without checking soundtrack.ts.

{ "ocm": "1", "id": "artmsilva-agent-tools-pi-vibes", "kind": "skill", "name": "pi-vibes", "description": "Pi extension: ambient soundtrack, mood ring, and familiar footer status driven off a shared rolling window of tool events.", "publisher": "artmsilva", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Pi extension: ambient soundtrack, mood ring, and familiar footer status driven off a shared rolling window of tool events." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/artmsilva/agent-tools", "path": "packages/pi-vibes/AGENTS.md", "ref": "4b1b9779f1b269016e761bd37417886b029f139d", "url": "https://github.com/artmsilva/agent-tools/blob/4b1b9779f1b269016e761bd37417886b029f139d/packages/pi-vibes/AGENTS.md", "key": "artmsilva/agent-tools/packages/pi-vibes/AGENTS.md" } }, "instructions": "# Package instructions\n\n## Scope\n\nPi extension: ambient soundtrack, mood ring, and familiar footer status driven\noff a shared rolling window of tool events.\n\n## Validation\n\n```bash\nnpm test\n```\n\n## Guardrails\n\n- Mood and familiar share one footer status key (`ctx.ui.setStatus(\"vibes\",\n ...)`) — pi's footer shows all status keys together, so don't split them.\n- Sound spawns must stay `{ detached: true, stdio: \"ignore\" }` + `.unref()`,\n and the animation timer must stay `setInterval(...).unref()` — neither may\n keep the process alive.\n- `updateLastStatus()` swallows a stale-`ctx` throw and dr", "cost": { "context_tokens": 229 } }

pi-vibes

About

Package instructions

Scope

Validation

Guardrails

Use it

Manifest

Reviews