agent-wormhole
Use Agent Wormhole for one-time sealed handoffs between autonomous agents, including encrypted mission briefs, scoped secrets, temporary artifacts, receipts, config drops, CLI/API usage, ECHO holder access, and Bankr x402 paid opens.
Install / Use
npx skills add BankrBot/skills --skill agent-wormholeInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of agent-wormhole
agent-wormhole scores 89/100 on our quality scale, 1661st of 4,698 Development & Engineering skills we index (top 36%).
Its SKILL.md is 4.6 KB long, well organised into 9 sections with 6 code examples: a solid amount of guidance for an agent.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so agent-wormhole is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
agent-wormhole compared with similar skills
All 4 of these similar skills score higher than agent-wormhole; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| agent-wormhole (this skill)by BankrBot | 89 | 1.2k | 54d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install agent-wormhole?
- Run
npx skills add BankrBot/skills --skill agent-wormhole. The install tabs above show the steps for each supported agent. - Which AI agents does agent-wormhole work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is agent-wormhole safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is agent-wormhole still maintained?
- The repository was last updated about 2 months ago, so agent-wormhole is actively maintained.
Skill content
View source on GitHubname: agent-wormhole description: Use Agent Wormhole for one-time sealed handoffs between autonomous agents, including encrypted mission briefs, scoped secrets, temporary artifacts, receipts, config drops, CLI/API usage, ECHO holder access, and Bankr x402 paid opens. emoji: 🕳️ tags: [agents, handoff, encrypted, x402, base, echo] visibility: public
Agent Wormhole
Agent Wormhole opens a temporary encrypted passage for agent handoffs. The payload can be claimed once, then the channel collapses.
Before First Use
This skill executes the @builtbyecho/agent-wormhole npm package. Before running any agent-wormhole or npx @builtbyecho/agent-wormhole command for the first time in a session, tell the user:
About to install/run
@builtbyecho/agent-wormhole(v0.1.2) from npm. It is an encrypted one-time-handoff CLI that writes payloads to a local.agent-wormholes/directory and (for holder/paid opens) callsstorage.builtbyecho.xyzand the Bankr x402 endpoint. It does NOT sign transactions or access private keys.Proceed? (y/n)
Wait for explicit confirmation before the first invocation. Subsequent calls in the same session do not need to re-prompt.
Pin the version when invoking via npx:
npx -p @builtbyecho/agent-wormhole@0.1.2 agent-wormhole <args>
Links
- Website:
https://www.builtbyecho.xyz - Product page:
https://www.builtbyecho.xyz/agent-wormhole.html - Source:
https://github.com/BuiltByEcho/agent-wormhole - Package:
https://www.npmjs.com/package/@builtbyecho/agent-wormhole - Hosted skill file:
https://www.builtbyecho.xyz/skills/agent-wormhole/SKILL.md
Use this skill when a task involves:
- sending or receiving one-time agent handoffs
- passing mission briefs, configs, receipts, files, or scoped secrets
- using the
agent-wormholeCLI or HTTP API - checking ECHO holder sponsored access
- checking Bankr x402 paid open status
- deploying or operating the VPS service
Quick Commands
From a project that has the package installed:
agent-wormhole send --text "mission brief" --ttl 10m
agent-wormhole send --file ./artifact.tgz --note "handoff bundle"
agent-wormhole inspect <code>
agent-wormhole receive <code> --out ./received
agent-wormhole cleanup --delete-claimed-older-than 15m
For one-off use without installing globally:
npx -p @builtbyecho/agent-wormhole@0.1.2 agent-wormhole send --text "mission brief"
Mental Model
- Codes are
id.secret. idlocates stored metadata.secretderives the AES-256-GCM decrypt key and is not stored.- Default TTL is 10 minutes.
- Max TTL is 24 hours unless explicitly configured lower.
- Default max payload is 5 MB.
- Receipts are written for opens and claims.
Access Paths
- Local CLI/library opens record
access.path = local. - Direct API holder opens require an EIP-191 signature from a wallet holding at least
50,000,000 ECHOon Base and recordaccess.path = echo_holder. - Bankr x402 paid opens are handled by
agent-wormhole-openand recordaccess.path = x402_paid. - Claiming is free.
Live Endpoints
- Direct holder/API route:
https://storage.builtbyecho.xyz/agent-wormhole - Bankr x402 paid open:
https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open - Self-hosted local service default:
http://127.0.0.1:8791
Verification
From the package root:
npm test
node --check src/cli.js
node --check src/index.js
node --check src/server.js
npm pack --json --dry-run
For live health:
curl -sS https://storage.builtbyecho.xyz/agent-wormhole/health
For Bankr status, check both registry and execution:
bankr --config "$BANKR_OWNER_CONFIG" x402 list
bankr x402 schema https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open
bankr --config "$BANKR_PAYER_CONFIG" x402 call -X POST -d '{"payload":"dGVzdA=="}' --max-payment 0.01 -y --raw https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open
Set BANKR_OWNER_CONFIG to the endpoint owner/operator config and BANKR_PAYER_CONFIG to a separate payer config. Do not treat registry active status alone as proof that paid x402 execution works. A real paid call from a non-owner wallet is the proof.
Safety
- Do not paste wormhole codes into public channels unless the user explicitly wants the payload claimable by anyone there.
- Do not log plaintext secrets or payloads.
- Prefer short TTLs for secrets.
- Use local cleanup commands for received artifacts when they are no longer needed.
- Do not test Bankr paid endpoints with the same wallet that owns/deployed the endpoint.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
