How do I install the Build Docker Image skill?

Run npx skillmds@latest add hyperlane-xyz/build-docker-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Build Docker Image safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Build Docker Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Build Docker Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Build Docker Image?

hyperlane-xyz (@hyperlane-xyz) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Build Docker Image by hyperlane-xyz

Name: Build Docker Image
Author: hyperlane-xyz

File contents

Trigger Docker Image Builds

Build and publish Docker images to GHCR (ghcr.io/hyperlane-xyz/*).

Workflows

Workflow	Image(s)	Contents
`rust-docker.yml`	`hyperlane-agent`	Rust relayer, validator, scraper
`monorepo-docker.yml`	`hyperlane-monorepo`	Full TS/Solidity monorepo
`node-services-docker.yml`	`hyperlane-node-services`	All TS node services (rebalancer, warp-monitor, ccip-server, keyfunder, relayer)

How to Trigger

Use gh workflow run with --ref to specify the branch, tag, or commit:

# Agent image (Rust)
gh workflow run rust-docker.yml --ref <branch>

# Monorepo image
gh workflow run monorepo-docker.yml --ref <branch>

# Node services (single unified image)
gh workflow run node-services-docker.yml --ref <branch>

# Include arm64 (multi-arch, slower)
gh workflow run rust-docker.yml --ref <branch> -f include_arm64=true

--ref defaults to main if omitted.

After Triggering

Get the run URL:

gh run list --workflow=<workflow>.yml --limit=1 --json url --jq '.[].url'

Get the run ID (wait a few seconds after triggering for the run to appear):

gh run list --workflow=<workflow>.yml --limit=1 --json databaseId,status,createdAt --jq '.[0]'

Watch it:
```
gh run watch <run-id>
```
The resulting image tag will be <7-char-sha>-<YYYYMMDD>-<HHMMSS>, e.g. c558a9f-20260304-105241.
Images are at ghcr.io/hyperlane-xyz/<image-name>:<tag>.

Instructions

Ask the user which image(s) they want to build (agent, monorepo, node services, or all).
Ask which branch/ref (default: main).
Ask if arm64 is needed (default: no).
Trigger the workflow(s) with gh workflow run.
Fetch and report the run URL(s) using gh run list.
Optionally watch for completion if the user wants to wait.

References

To find existing images instead of building, use the /find-docker-image skill.
See docs/docker-image-policy.md for the full Docker image policy.

---name: build-docker-imagedescription: Trigger Docker image builds for Hyperlane agent, monorepo, or node service images. Use when the user wants to build new Docker images for a branch, commit, or tag.---# Trigger Docker Image BuildsBuild and publish Docker images to GHCR (`ghcr.io/hyperlane-xyz/*`).## Workflows| Workflow | Image(s) | Contents || -------------------------- | ------------------------- | -------------------------------------------------------------------------------- || `rust-docker.yml` | `hyperlane-agent` | Rust relayer, validator, scraper || `monorepo-docker.yml` | `hyperlane-monorepo` | Full TS/Solidity monorepo || `node-services-docker.yml` | `hyperlane-node-services` | All TS node services (rebalancer, warp-monitor, ccip-server, keyfunder, relayer) |## How to TriggerUse `gh workflow run` with `--ref` to specify the branch, tag, or commit:```bash# Agent image (Rust)gh workflow run rust-docker.yml --ref <branch># Monorepo imagegh workflow run monorepo-docker.yml --ref <branch># Node services (single unified image)gh workflow run node-services-docker.yml --ref <branch># Include arm64 (multi-arch, slower)gh workflow run rust-docker.yml --ref <branch> -f include_arm64=true````--ref` defaults to `main` if omitted.## After Triggering1. Get the run URL: ```bash gh run list --workflow=<workflow>.yml --limit=1 --json url --jq '.[].url' ```2. Get the run ID (wait a few seconds after triggering for the run to appear): ```bash gh run list --workflow=<workflow>.yml --limit=1 --json databaseId,status,createdAt --jq '.[0]' ```3. Watch it: ```bash gh run watch <run-id> ```4. The resulting image tag will be `<7-char-sha>-<YYYYMMDD>-<HHMMSS>`, e.g. `c558a9f-20260304-105241`.5. Images are at `ghcr.io/hyperlane-xyz/<image-name>:<tag>`.## Instructions1. Ask the user which image(s) they want to build (agent, monorepo, node services, or all).2. Ask which branch/ref (default: `main`).3. Ask if arm64 is needed (default: no).4. Trigger the workflow(s) with `gh workflow run`.5. Fetch and report the run URL(s) using `gh run list`.6. Optionally watch for completion if the user wants to wait.## References- To find existing images instead of building, use the `/find-docker-image` skill.- See `docs/docker-image-policy.md` for the full Docker image policy.

Frequently asked questions

Build Docker Image