KV-investigator

Synthesize CockroachDB KV test failure context from logs and artifacts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tbg/cursorfiles --skill kv-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: KV-investigator
Source: https://github.com/tbg/cursorfiles/tree/main/kv-commands/investigator/.claude/skills/kv-investigator
Command: npx skills add https://github.com/tbg/cursorfiles --skill kv-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigating CockroachDB KV test failures can be time-consuming and noisy without a structured workflow. This skill provides a guided approach to gather context, artifacts, and logs, map failures to root causes, and propose concrete remediation steps.

Core Features & Use Cases

  • Gather and synthesize test failure context from issues, logs, and artifacts (including SHAs) to build a comprehensive failure narrative.
  • Analyze and correlate data across roachtests and Go unit tests in the KV space to identify root causes and potential fixes.
  • Produce actionable next steps, severity assessment, and recommendations for triage and debugging workflows.

Quick Start

Invoke this skill when you need to investigate a KV test failure and begin a structured triage workflow.

Frequently Asked Questions about KV-investigator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate a CockroachDB KV test failure using logs and artifacts?

To investigate a CockroachDB KV test failure, you gather and synthesize context, logs, and artifacts using exact SHAs to build a comprehensive failure narrative. This structured triage workflow applies to both roachtests and Go unit tests to map failures to root causes.

What's the best way to triage roachtest failures in the KV area?

The best way to triage roachtest failures in the KV area is to apply a structured workflow that gathers test failure context, analyzes and correlates data across logs and artifacts, and identifies root causes to propose actionable remediation steps for debugging.

Can I use this approach for both roachtests and Go unit tests in CockroachDB?

Yes, this investigation approach works for both roachtests and Go unit tests within the CockroachDB KV space. It uses exact SHAs and associated artifacts to analyze and correlate data across both test types to identify root causes and potential fixes.

What is root-cause analysis for CockroachDB test failures?

Root-cause analysis for CockroachDB test failures is the process of gathering and synthesizing context, logs, and artifacts to map failures to their origins. It produces actionable next steps, severity assessment, and recommendations for triage and debugging workflows.

How do I get actionable next steps after analyzing KV test failure logs?

After analyzing KV test failure logs, you get actionable next steps by correlating data across issues and artifacts to identify root causes and potential fixes. The structured investigation guidance produces severity assessments and concrete remediation recommendations for debugging.