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
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
84bc1e4
Table of Contents
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.