Analyzes transaction fingerprints using aggregated statistics from crdb_internal.transaction_statistics to identify high-retry transactions, contention patterns, and commit latency issues. Provides historical transaction-level analysis to understand which statement combinations are causing retries, contention, or performance degradation. Use when investigating transaction retry storms, analyzing commit latency trends, or understanding statement composition of problematic transactions without DB Console access.
89
86%
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 articulates specific capabilities, includes rich domain-specific trigger terms, and explicitly states both what the skill does and when to use it. The description is well-scoped to a distinct niche (CockroachDB transaction-level statistics analysis) and uses appropriate third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: analyzing transaction fingerprints, identifying high-retry transactions, contention patterns, commit latency issues, and understanding statement combinations causing retries/contention/performance degradation. | 3 / 3 |
Completeness | Clearly answers both what ('Analyzes transaction fingerprints using aggregated statistics... to identify high-retry transactions, contention patterns, and commit latency issues') and when ('Use when investigating transaction retry storms, analyzing commit latency trends, or understanding statement composition of problematic transactions without DB Console access'). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'transaction retry storms', 'commit latency', 'contention patterns', 'transaction_statistics', 'crdb_internal', 'DB Console', 'retries', 'performance degradation'. These cover the domain-specific vocabulary a CockroachDB user would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: CockroachDB transaction-level statistics analysis via crdb_internal.transaction_statistics. The specific data source, analysis type (transaction fingerprints vs statement-level), and use cases (retry storms, commit latency) make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%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 diagnostic skill with 7 executable SQL queries and 4 clear workflows for CockroachDB transaction analysis. Its main weakness is verbosity—repeated cross-references, explanations of concepts Claude already knows (JSON operators, time bucketing), and duplicated guidance across sections inflate the token count. The workflows would benefit from explicit validation checkpoints rather than just sequential steps.
Suggestions
Reduce redundancy by consolidating cross-references to related skills into a single section rather than repeating them in the introduction, 'When to Use', and 'References' sections.
Trim the 'Core Concepts' section—remove explanations of JSON operators (`->`, `->>`), type casting, and basic concepts Claude already knows; keep only CockroachDB-specific field paths and units.
Add explicit validation checkpoints to workflows, e.g., 'Verify Query 1 returns results before proceeding' or 'If no high-retry transactions found, expand time window to 7 days and re-run'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is thorough but verbose. Several sections repeat information (e.g., cross-references to related skills appear 3+ times, safety/performance considerations are restated in multiple places). The 'Core Concepts' section explains things like JSON operators and time-series bucketing that Claude likely already knows. The 'When to Use This Skill' section largely duplicates the introduction. However, the SQL queries themselves are lean and well-targeted. | 2 / 3 |
Actionability | All 7 diagnostic queries are fully executable SQL with proper JSON extraction, type casting, and filtering. Each query includes interpretation guidance and key column explanations. The cross-reference join in Query 7 is particularly well-constructed with the decode/encode pattern. Every query is copy-paste ready against a CockroachDB cluster. | 3 / 3 |
Workflow Clarity | Four workflows are clearly sequenced with numbered steps and cross-references to specific queries. However, none include explicit validation checkpoints or feedback loops for error recovery. For diagnostic workflows involving production databases, there should be verification steps (e.g., 'confirm results are non-empty before proceeding' or 'validate that the time window captures the incident'). The remediation steps are vague ('adjust transaction boundaries'). | 2 / 3 |
Progressive Disclosure | The skill has a clear overview structure with well-signaled references to detailed materials: JSON field reference, metrics catalog, SQL query variations, and permissions reference. Cross-references to related skills (profiling-statement-fingerprints, triaging-live-sql-activity) are clearly signaled with context about when to use each. The main content stays at the right level of detail with deeper content delegated to reference files. | 3 / 3 |
Total | 10 / 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.