agentleFS
hyperlane-xyzhyperlane-xyz/hyperlane-monorepo/.agents/skills/warp-fork/SKILL.md

warp-fork

Skill76 starsChanged 20 days agoApache-2.0View on GitHub

Fork a warp route using the local HTTP registry. Instructions: Prerequisites: Related skills: Example output: Started warp fork for EZETH/ethereum-megaeth in background (shell ID: shell_abc123). To stop it later, I can use KillShell with that ID.

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Check if http://localhost:3333 is running.

    line 16
  2. Distinctive:

    Run the command in the background:

    line 23
  3. Very specific:

    Use the registry URL from step 0 for $REGISTRY (http://localhost:3333 by default, or user-provided if the local registry failed)

    line 29
  4. Very specific:

    Use run_in_background: true so it doesn't block the conversation.

    line 30
  5. Distinctive:

    After starting, report the task/shell ID and the fork registry server port back to the user.

    line 32

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Warp Fork

Fork a warp route using the local HTTP registry.

Instructions:

  1. Check if http://localhost:3333 is running. If not, run the start-http-registry SKILL. If that fails, ask the user to prompt the user for an alternate registry URL to use instead of http://localhost:3333.
  2. First, ask the user to prompt the user for the warp route ID:
    • Question: "Which warp route would you like to fork?"
    • Header: "Warp Route"
    • Options: Provide 2-3 common examples if known, otherwise use generic placeholders. Note that the fork may fail if the warp routes are invalid. Re-prompt the user!
  3. Run the command in the background:

    pnpm -C typescript/cli exec tsx cli.ts warp fork --registry $REGISTRY --warpRouteId $WARP_ROUTE_ID
    • Use the registry URL from step 0 for $REGISTRY (http://localhost:3333 by default, or user-provided if the local registry failed)
    • Use run_in_background: true so it doesn't block the conversation.
  4. After starting, report the task/shell ID and the fork registry server port back to the user.
  5. Remind the user they can stop it later with KillShell using that ID

Prerequisites:

  • The http-registry server must be running on port 3333. If not, start it first with /start-http-registry.
  • Forking is per-protocol: EVM chains need Foundry anvil on PATH; Sealevel chains need a locally-installed surfpool binary (>= 1.5.0) on PATH — there is no Docker fallback in the CLI. Install the pinned, checksum-verified surfpool release the way CI does — see the Install surfpool step in .github/workflows/test-cli-e2e.yml (a pinned v1.5.0 release tarball verified against its SHA-256); do not pipe the mutable run.surfpool.run installer to a shell. If the binary is missing, warp fork aborts with a "surfpool 1.5.0+ is required" error before forking.

Related skills:

  • /warp-simulate-safe-txs — EVM fork → replay a Safe batch → check.
  • /warp-simulate-svm-txs — Sealevel fork → replay SVM/Squads governance txs → check.

Example output:

Started warp fork for EZETH/ethereum-megaeth in background (shell ID: shell_abc123). To stop it later, I can use KillShell with that ID.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.