managing-cluster-settings
Reviews, audits, and modifies CockroachDB cluster settings. Self-Hosted has full control over all settings and start flags. Advanced/BYOC can modify most SQL-level settings but infrastructure settings are managed by CRL. Standard has limited settings access — session variables are the primary tuning mechanism. Basic has minimal settings — use session variables and Cloud Console. Use when auditing configuration, tuning performance, or troubleshooting settings-related issues.
94
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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 its scope (CockroachDB cluster settings management), provides tier-specific detail that aids in correct skill selection, and includes an explicit 'Use when' clause with relevant trigger scenarios. The description is concise yet comprehensive, using third-person voice throughout and covering both capabilities and activation conditions effectively.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions ('reviews, audits, and modifies CockroachDB cluster settings') and provides specific details about what each deployment tier can do, including SQL-level settings, start flags, session variables, and Cloud Console. | 3 / 3 |
Completeness | Clearly answers both 'what' (reviews, audits, and modifies CockroachDB cluster settings with tier-specific details) and 'when' (explicit 'Use when auditing configuration, tuning performance, or troubleshooting settings-related issues'). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms: 'CockroachDB', 'cluster settings', 'auditing configuration', 'tuning performance', 'troubleshooting', 'session variables', 'Cloud Console', and deployment tier names (Self-Hosted, Advanced, BYOC, Standard, Basic) that users would naturally mention. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — focuses specifically on CockroachDB cluster settings across deployment tiers, which is a clear niche unlikely to conflict with other skills. The tier-specific details further narrow its scope. | 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 well-structured, highly actionable skill that effectively handles a complex multi-tier routing problem. The context-gathering approach and tier-specific sections provide clear guidance for each deployment scenario. Minor verbosity in explanatory text and context tables could be tightened, but overall the skill is strong across all dimensions.
Suggestions
Trim the context-gathering tables — Claude can infer why tier matters without explicit 'Why It Matters' columns; consider condensing to a simple list of questions per tier.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured but includes some unnecessary verbosity, such as the context-gathering tables that could be more compact, and explanations like 'CockroachDB Self-Hosted requires an enterprise license for features like backup/restore, changefeeds, encryption at rest, and multi-region capabilities' that Claude would already know. The tier-specific sections are reasonably lean but the overall document could be tightened. | 2 / 3 |
Actionability | The skill provides fully executable SQL commands throughout — SHOW, SET, RESET, ALTER ROLE, ALTER RANGE — with concrete examples and specific setting names. The audit queries are copy-paste ready, and the modification workflow (show current → set → verify) is explicit and actionable. | 3 / 3 |
Workflow Clarity | The safety considerations section provides a clear pre-modification checklist (document current value, verify not mid-upgrade, understand impact, change one at a time, monitor). The modify-a-setting workflow has explicit verify steps. Context-driven routing table clearly sequences the decision process. Feedback loops are present (verify after change, monitor for 15-30 minutes). | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to five reference files (sql-queries.md, recommended-values.md, node-level-settings.md, cloud-restricted-settings.md, safety-guide.md) and related skills. Content is appropriately split between the main skill and references, with the main file containing actionable procedures and references holding detailed lists. | 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.
- Repository
- cockroachlabs/cockroachdb-skills
- Commit
84bc1e4
- 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.