CtrlK
BlogDocsLog inGet started
Tessl Logo

upgrading-cluster-version

Guides CockroachDB version upgrades with tier-appropriate procedures. Self-Hosted covers manual rolling binary replacement with finalization control. Advanced/BYOC covers Console-initiated major upgrades, maintenance windows for patches, and release channel selection. Standard and Basic upgrades are fully automatic with no customer action required. Use when planning, executing, or monitoring a version upgrade.

94

Quality

92%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly articulates what it does (guides CockroachDB version upgrades across different deployment tiers with specific procedures for each) and when to use it (planning, executing, or monitoring upgrades). The tier-specific details provide excellent specificity and distinctiveness, and the natural trigger terms cover the domain well.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions across different tiers: 'manual rolling binary replacement with finalization control', 'Console-initiated major upgrades', 'maintenance windows for patches', 'release channel selection', and notes automatic upgrades for lower tiers.

3 / 3

Completeness

Clearly answers both 'what' (tier-appropriate upgrade procedures with specific details per tier) and 'when' ('Use when planning, executing, or monitoring a version upgrade'). The explicit 'Use when...' clause covers the key trigger scenarios.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'version upgrade', 'CockroachDB', 'Self-Hosted', 'Advanced', 'BYOC', 'Standard', 'Basic', 'rolling binary replacement', 'maintenance windows', 'patches', 'release channel', 'planning', 'executing', 'monitoring'. Good coverage of terms a user working with CockroachDB upgrades would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — focuses specifically on CockroachDB version upgrades with tier-specific procedures. The combination of CockroachDB + version upgrades + tier differentiation creates a clear niche unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality, comprehensive upgrade skill that excels in actionability and workflow clarity, particularly for the Self-Hosted tier which has the most complex procedure. The tier-based routing and context-gathering approach is well-designed. Minor inefficiencies exist in the Standard/Basic sections and some explanatory columns, but overall the skill is well-structured and immediately useful.

DimensionReasoningScore

Conciseness

The skill is generally efficient and well-structured with tables and code blocks, but includes some unnecessary content like the Standard and Basic tier sections which are essentially 'nothing to do' and could be condensed to a single line each. The context-gathering tables are thorough but slightly verbose with 'Why It Matters' columns that explain things Claude could infer.

2 / 3

Actionability

Excellent actionability throughout — provides fully executable SQL queries for pre-upgrade validation, concrete bash commands for each deployment platform (systemd, K8s Operator, Helm, manual), specific SQL for monitoring and finalization, and even a Cloud API curl command. All code is copy-paste ready with clear placeholders.

3 / 3

Workflow Clarity

The Self-Hosted upgrade workflow is exceptionally well-sequenced with explicit validation checkpoints: pre-upgrade validation queries, per-node verification before proceeding, finalization gating on all nodes matching, and a clear rollback path. The 'verify each node before proceeding to the next' checkpoint and the irreversibility warnings on finalization demonstrate strong feedback loops.

3 / 3

Progressive Disclosure

Content is well-organized with clear tier-based routing table, cross-references to related skills (cluster health, maintenance, settings) that are one level deep and clearly signaled. The internal document structure uses headers and a routing table effectively, and external references to official docs are cleanly listed at the end.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
cockroachlabs/cockroachdb-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.