kafka-add-broker

Bootstrap and join a Kafka broker into a KRaft cluster.

2|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/heyAyushh/hook --skill kafka-add-broker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kafka-add-broker
Source: https://github.com/heyAyushh/hook/tree/main/skills/kafka-add-broker
Command: npx skills add https://github.com/heyAyushh/hook --skill kafka-add-broker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, tar, and includes scripts (resource) components.

What problem does it solve?

Provision and join a new Kafka broker into a KRaft cluster or connect to an externally managed Kafka cluster to scale capacity and improve resilience.

Core Features & Use Cases

  • Mode A: Add a broker to an existing KRaft cluster and join it to the cluster.
  • Mode B: Point hook to an external Kafka cluster to reuse an existing deployment.
  • Simplified bootstrap that uses environment variables like KAFKA_NODE_ID, KAFKA_CLUSTER_ID, and KAFKA_QUORUM_VOTERS to configure the broker and start it reliably.

Quick Start

Run the bootstrap-kafka-broker script on a new broker VM after configuring KAFKA_NODE_ID, KAFKA_CLUSTER_ID, and KAFKA_QUORUM_VOTERS to join the cluster.

Frequently Asked Questions about kafka-add-broker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new broker to an existing Kafka KRaft cluster?

To add a Kafka broker to a KRaft cluster, configure the KAFKA_NODE_ID, KAFKA_CLUSTER_ID, and KAFKA_QUORUM_VOTERS environment variables on a new VM. The bootstrap script writes configurations to /etc/kafka/kraft and starts a systemd service to join the node to the cluster.

What environment variables are required to bootstrap a Kafka broker?

Bootstrapping a Kafka broker requires explicit KAFKA_NODE_ID, KAFKA_CLUSTER_ID, and KAFKA_QUORUM_VOTERS environment variables. You must also ensure a compatible Kafka version is installed and dependencies like curl and tar are available on the system.

Can I connect a new broker node to an externally managed Kafka cluster?

Yes, you can point the hook to an external Kafka cluster to reuse an existing deployment. Mode B allows you to connect to an externally managed cluster, simplifying the process of scaling out brokers and increasing redundancy without managing the internal KRaft quorum directly.

Why do I need to scale out Kafka brokers?

Scaling out Kafka brokers increases cluster capacity and improves resilience by adding redundancy. Joining new broker nodes allows hook components to target the new broker across modes, distributing load and ensuring high availability.

What dependencies are needed to run the Kafka broker bootstrap script?

Running the Kafka broker bootstrap script requires curl and tar installed on the system. You also need a compatible Kafka version and the necessary environment variables configured to successfully write to /etc/kafka/kraft and start the systemd service.