CtrlK
BlogDocsLog inGet started
Tessl Logo

reviewing-cluster-health

Performs a comprehensive health check of a CockroachDB cluster. Gathers deployment context first, then provides tier-appropriate diagnostics. Self-Hosted uses SQL against node-level system tables and CLI. Advanced/BYOC use Cloud Console and SQL with node visibility. Standard monitors provisioned compute and workload via Cloud Console. Basic monitors Request Unit consumption and connectivity. Use for daily checks, pre-maintenance validation, post-incident verification, or production readiness assessment.

94

Quality

92%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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 an excellent skill description that clearly defines what it does (CockroachDB cluster health checks with tier-specific diagnostics), how it operates across different deployment tiers, and when to use it (daily checks, pre-maintenance, post-incident, production readiness). It uses third-person voice throughout and includes rich, natural trigger terms. The tier-specific detail adds both specificity and distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: health check of CockroachDB cluster, gathers deployment context, tier-appropriate diagnostics with detailed breakdowns for Self-Hosted (SQL against node-level system tables and CLI), Advanced/BYOC (Cloud Console and SQL), Standard (provisioned compute and workload), and Basic (Request Unit consumption and connectivity).

3 / 3

Completeness

Clearly answers both 'what' (comprehensive health check with tier-specific diagnostics for CockroachDB clusters) and 'when' with explicit triggers: 'Use for daily checks, pre-maintenance validation, post-incident verification, or production readiness assessment.'

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'health check', 'CockroachDB', 'cluster', 'daily checks', 'pre-maintenance', 'post-incident', 'production readiness', 'diagnostics', 'Self-Hosted', 'Cloud Console', 'BYOC', 'Standard', 'Basic'. These cover multiple natural ways a user might phrase their request.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — targets a specific database product (CockroachDB), a specific task (health check), and differentiates by deployment tier. Very unlikely to conflict with other skills given the narrow, well-defined niche.

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 strong, well-structured skill that provides comprehensive, tier-appropriate health check guidance for CockroachDB clusters. Its greatest strength is actionability — every tier gets concrete, executable queries with built-in health status assessments. Minor conciseness improvements could be made by trimming redundant SQL blocks between Standard/Basic and reducing some explanatory text about tier characteristics, but overall the content earns its length given the complexity of covering five deployment tiers.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient given its complexity (5 tiers), but there's some redundancy — the context-gathering tables are verbose, the Standard and Basic SQL checks are nearly identical, and some explanatory text (e.g., describing what each tier is) could be trimmed since Claude can be told this more concisely.

2 / 3

Actionability

Excellent actionability throughout. Every tier has concrete, executable SQL queries and CLI commands that are copy-paste ready. The queries include computed columns with CASE expressions for health status assessment, specific thresholds for warnings/critical states, and clear interpretation guidance.

3 / 3

Workflow Clarity

The workflow is well-structured: gather context first, route to the appropriate tier, then execute numbered/labeled queries in sequence. Each query has clear interpretation notes. The pre-maintenance conditional check for running jobs is a good validation checkpoint. Safety considerations and troubleshooting provide error recovery guidance.

3 / 3

Progressive Disclosure

Content is well-organized with clear section routing by tier, internal anchor links for navigation, and references to external files (production-readiness.md) and related skills. The BYOC section efficiently reuses Advanced checks by reference rather than duplicating them. External documentation links are well-categorized.

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.