# Cluster Scaling

> Capacity changes for the shared Kubernetes clusters.

- Skill: `stbenjam/cluster-scaling` (Agent Skill)
- Install (CLI): `npx skillmds@latest add stbenjam/cluster-scaling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stbenjam/cluster-scaling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: stbenjam (https://skillmd.com/u/stbenjam)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/stbenjam/cluster-scaling

---


# Scale Cluster

Adds or removes node capacity, and adjusts the autoscaler bounds that
decide how far it can move on its own.

## Before changing anything

Read the current headroom from [the capacity
dashboard](docs/capacity-dashboard.md). A cluster under 20% headroom at
peak is scaled up before any other change.

## Making the change

Node pools are declared in [the cluster
manifest](config/node-pools.yaml). Change the manifest, not the live
cluster; the reconciler reverts manual edits within ten minutes.