CockroachDB Skills

A curated collection of Agent Skills for CockroachDB—structured, machine-executable capabilities that encode CockroachDB expertise. This repository enables AI agents, automation systems, and developer tools to deliver contextually aware, production-grade CockroachDB operations.

---

For Users

Want to use these skills with your AI agent?

→ Installation Guide - Get started in 5 minutes → Usage Guide - Discover and invoke skills

Quick Start:

# One-line installation (works with Claude Code, Cursor, Windsurf, and 40+ agents)
npx skills add cockroachlabs/cockroachdb-skills

What you can do:

• Get expert guidance on CockroachDB operations
• Diagnose cluster health and performance issues
• Plan migrations from PostgreSQL
• Configure security and compliance features
• Optimize query performance
• …and 29+ other operational tasks

See complete skill list

---

For Contributors

What Is a CockroachDB Skill?

A CockroachDB Skill is a structured capability that:

• Encodes operational expertise - How experienced CockroachDB practitioners solve specific challenges
• Follows the Agent Skills Specification - Structured according to agentskills.io/specification
• Is machine-executable - Can be invoked by AI agents, automation platforms, and developer tools
• Has clear boundaries - Focused scope with explicit inputs, outputs, and safety guardrails
• References authoritative sources - Links directly to official CockroachDB documentation

Skills live in the skills/ directory, organized by operational domain. Each skill is a directory containing a SKILL.md file with frontmatter and structured content.

Quick Start

1. Review the Agent Skills Specification
2. Read our Contributing Guidelines
3. Browse existing skills in the skills/ directory
4. Propose a new skill using our issue template

What This Repository Is NOT

❌ Not a prompt library - Skills are not just conversational prompts ❌ Not LLM training data - Skills are runtime capabilities, not training material ❌ Not documentation mirrors - Skills encode operational reasoning, not docs copies ❌ Not vendor-locked - Skills are protocol-agnostic and specification-based ❌ Not a chat interface - Skills are structured capabilities for agents/automation

Skill Domains

Skills are organized into 9 operational domains that cover the full CockroachDB lifecycle:

1. Onboarding and Migrations