Back to Skills

build-kit-locally

Build a kit and publish it to a locally hosted registry for development testing

4stars11forksUpdated 3/1/2026

Security Assessment

Safe(100/100)
Security Score100/100

About build-kit-locally

The 'build-kit-locally' skill enables users to build and publish Bottlerocket kits locally to an OCI registry for development testing. It provides an efficient way for developers to test kit changes without the need to publish to production registries, reducing the risk of impacting production systems. By utilizing a local registry, the skill facilitates testing in various kit variants and ensures that changes can be validated in isolation before wider deployment. This process is invaluable for developers looking to iterate rapidly on kit changes while maintaining a streamlined development workflow.

FAQ

How do I ensure the local registry is running?

To ensure the local registry is running, use the command `brdev registry start`.

What if my Docker permissions are denied?

Ensure your user is in the docker group and that the Docker daemon is running.

Can I build the kit for a specific architecture?

Yes, you can specify the architecture when building by using the command `make build ARCH=x86_64` or `make build ARCH=aarch64`.

What should I do if my Infra.toml file is not configured?

Run `brdev twoliter use-local-publish` to create the necessary configuration for the local registry.

Install build-kit-locally

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill