managing-cluster-capacity

Automates CockroachDB cluster capacity planning and execution across deployment tiers.

3|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/cockroachdb/claude-plugin --skill managing-cluster-capacity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-cluster-capacity
Source: https://github.com/cockroachdb/claude-plugin/tree/main/skills/operations-and-lifecycle/managing-cluster-capacity
Command: npx skills add https://github.com/cockroachdb/claude-plugin --skill managing-cluster-capacity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Capacity planning and execution for CockroachDB deployments is often complex and error-prone due to multi-tier architectures, requiring manual coordination across node operations, cloud backends, and cost controls.

Core Features & Use Cases

  • Automates capacity planning and execution across all deployment tiers (Self-Hosted, Advanced, BYOC, Standard, Basic).
  • Coordinates decommissioning, node scaling, and machine-size adjustments with built-in safety checks and health validations.
  • Use Case: When expanding or reducing a CockroachDB deployment, this Skill orchestrates the required steps and validates capacity and safety constraints before applying changes.

Quick Start

Run the managing-cluster-capacity skill to assess current capacity and generate a safe scaling plan, then apply changes using your preferred backend (CLI, Cloud Console, or Terraform).

Frequently Asked Questions about managing-cluster-capacity

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

FAQPage Schema
How do I safely decommission nodes in a CockroachDB cluster?

To safely decommission CockroachDB nodes, you must run pre-checks to validate cluster health and safety constraints. This process orchestrates decommissioning to ensure data is properly redistributed before node removal across all deployment tiers.

What is the best way to scale CockroachDB capacity across different cloud tiers?

Scaling CockroachDB capacity across cloud tiers requires coordinating node additions and machine-size adjustments. This capacity planning applies uniformly across Self-Hosted, Advanced, BYOC, Standard, and Basic tiers to execute scaling changes safely.

How does CockroachDB capacity planning handle cost-control for cloud deployments?

CockroachDB capacity planning handles cost-control by integrating cost-management strategies directly into scaling and decommissioning operations. It validates capacity and safety constraints before applying changes to optimize cloud deployment expenses.

Can I manage CockroachDB cluster scaling using Terraform and CLI workflows?

Yes, you can manage CockroachDB cluster scaling using Terraform and CLI workflows. The capacity execution process supports CLI, Cloud Console, and Terraform backends to apply scaling changes and run post-check health validations.

What safety checks are required before adjusting machine sizes in CockroachDB?

Before adjusting machine sizes in CockroachDB, pre-checks and health validations are required to ensure operational safety constraints are met. This verifies cluster stability and capacity limits before executing any scaling adjustments.

Why does CockroachDB decommissioning fail and how do I remediate it?

CockroachDB decommissioning may fail if pre-checks identify health validation or safety constraint violations. Remediation steps are built into the capacity planning workflow to resolve these operational blocks before safely retrying.