Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/piperbox/piper/releasenpx skills add piperbox/piper --skill releasegit clone --depth 1 https://github.com/piperbox/piperWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00056 | $0.01993 |
| Opus 5 | $0.00028 | $0.00996 |
| Sonnet 5 | $0.00011 | $0.00399 |
| Haiku 4.5 | $0.00006 | $0.00199 |
Grade D, and why
release scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
Expected: installer configures apt.piperbox.dev, installs both debs, both versions print the latest stable. (Runs as root in the container, so no sudo is involved.) Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
docker run --rm debian:stable sh -c 'apt-get update -qq && apt-get install -y -qq curl ca-certificates >/dev/null && curl -fsSL https://get.piperbox.dev/install.sh | sh && piper --version && piperd --version' Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -fsSL https://get.piperbox.dev/install.sh \ How it starts
The opening of the file, as written. The whole thing — 164 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Cutting a Piper release
Releases are semver git tags. Pushing a v* tag triggers .github/workflows/release.yml, which runs goreleaser and publishes a GitHub Release. There is nothing else to run — but the tag is irreversible in practice, so the gates below come first.
Pre-1.0 (0.x), breaking changes may land in minor bumps. See CLAUDE.md's compatibility policy.
1. Preconditions
- On
main, clean tree, synced with origin. make verifyclean locally.
2. The gate: green on the exact tip
The release workflow does not re-run e2e. Whatever you tag is what ships, so verify CI + e2e + Code Quality all succeeded on the exact SHA you are about to tag:
TIP=$(git rev-parse main)
gh run list --branch main --limit 25 --json headSha,name,conclusion \
--jq ".[] | select(.headSha==\"$TIP\") | \"\(.name)\t\(.conclusion)\""
Do not use gh run list --commit <sha> — it has returned empty unreliably. Filter on headSha as above.
If a push-event run is missing entirely (GitHub has occasionally fired no push workflows for a squash-merge), tree-equality against a green PR run is an acceptable substitute: confirm git rev-parse <release-commit>^{tree} equals the tree of the PR head that e2e tested.
3. Choose the version
Ask the user rather than assuming — but bring a recommendation.
Minor bump when the release breaks anything a user must act on. Precedents:
v0.5.0— breaking API response shapev0.6.0— new columns on existing tables, so an in-place DB needs replacingv0.8.0— macOS launchd label changed, requiring a manuallaunchctl bootout
Patch only when nothing requires user action. A patch that silently breaks an upgrade path is worse than a minor: the version number is the only signal most users read.
Schema changes are subtler than they look
Both the agent and relay stores apply schema.sql with CREATE TABLE IF NOT EXISTS and there are no migrations anywhere.
- New table → materializes on an existing DB. Additive, no re-enroll.
- New column on an existing table → does not materialize. Needs a fresh DB and re-enrollment.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 164 lines · 56 tokens per session scan D c8fadf1bdbd2
release is a skill published in the GitHub repository piperbox/piper (10 stars, last pushed 2d ago), licensed Apache-2.0. It adds 56 tokens to every session and 1,993 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
dokku-deploy
PaaS deployment with Dokku.
coolify
Use when self-hosting apps and databases with Coolify on a VPS you own — install, first-admin lockdown, Git-to-deploy (Nixpacks/Dockerfile/compose), managed Postgres/Redis, scheduled S3 backups, domains + auto-SSL. NOT a PaaS someone else runs (that is railway), NOT sizing/hardening the box (that is hetzner), NOT…
tianji-data-query
Query website analytics, monitor uptime, survey results, telemetry data, feed events, application stats, and more from the Tianji platform via its read-only OpenAPI (69 GET endpoints across 14 service domains). Use when the user asks about website traffic, pageviews, monitor status, survey feedback, telemetry events…
fix-issues
Fix a batch of open GitHub issues end to end - one git worktree and one agent per issue (feature-dev for implementation, review-pr for review), individual PRs into develop, a release PR to main with a final multi-agent integration review, and optional tag/release/issue-comment publishing. Use when the user asks to…
ecspresso
ECS deployment tool - deploy, manage, and troubleshoot ECS services.
nvcf-self-managed-installation
Install and operate NVCF self-hosted control-plane and separate compute-plane stacks. Covers Helmfile values and CLI profile installation flows, teardown, values overrides, pull secrets, and troubleshooting. Use for nvcf-self-managed-stack, nvcf-compute-plane-stack, split compute-plane installation, control-plane…