Individual skill

headroom

Plans capacity, performance, and resilience from measured or explicitly estimated demand. Use for scalability decisions, growth planning, service targets, bottleneck forecasts, queue or cache sizing, and Now/Next/Scale plans. Do not use to debug a known slow path or implement a feature.

skills/headroom/SKILL.md

Read pinned source

Source commit cfa78f744564cec2c5aaf0cbacbada58d79b9e59

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 12
Repository last updated: Nov 2, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

agent-skills Repository topic
agentic-coding Repository topic
ai-agents Repository topic
ai-coding Repository topic
code-review Repository topic
coding-agents Repository topic
debugging Repository topic
developer-productivity Repository topic
developer-tools Repository topic
llm Repository topic
marketing Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 14,324 bytes
assets/capacity-case.jsonasset · 865 bytes
references/dimensions.mddoc · 2,097 bytes
references/research.mddoc · 2,747 bytes
references/workload-experiments.mddoc · 2,031 bytes

Read excerpt


# headroom: capacity decisions with an expiry date

## Purpose and scope

Use this skill to decide what a system needs now, what evidence should trigger
the next change, and what belongs in a deliberately deferred scale design. It
produces a decision record, not invented load-test results or an architecture
assembled from fashionable components.

Capacity belongs to a workload and an objective: traffic alone is not a model.
Consider request shape, concurrency, data growth, dependency limits, failure
behavior, recovery objectives, operational ownership, and cost where they can
change a decision. State every unknown, estimate, source, and confidence level.