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.
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.
- Review the Agent Skills Specification
- Read our Contributing Guidelines
- Browse existing skills in the
skills/directory - Propose a new skill using our issue template
❌ 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
Skills are organized into 9 operational domains that cover the full CockroachDB lifecycle:
Getting started with CockroachDB and moving workloads into the system.
Building applications that use CockroachDB effectively.
Optimizing query performance and scaling CockroachDB clusters.
Day-to-day cluster operations and version management.
Ensuring high availability and preparing for failures.
Monitoring, alerting, and diagnosing issues.
Access control, compliance, and data protection.
Connecting CockroachDB to external tools and platforms.
Understanding and optimizing resource consumption.
We welcome contributions from the community! To contribute:
- Propose a skill: Open an issue using the new skill template
- Get alignment: Discuss scope, domain, and approach with maintainers
- Implement: Follow the Agent Skills Specification
- Submit PR: Use our pull request template
- Iterate: Address feedback and ensure CI passes
See CONTRIBUTING.md for detailed guidelines.
Each skill addresses one specific task with clear boundaries. Skills that try to do too much are harder to maintain, test, and compose.
Skills start with essential context and progressively reveal details. Core concepts come first, edge cases and troubleshooting come later.
Skills that can modify data or affect availability include explicit safety checks, confirmation prompts, and rollback guidance.
Skills link to official CockroachDB documentation rather than duplicating it. When docs change, skills remain accurate.
Skill descriptions include clear "when to use" signals so agents can discover and invoke them contextually.
All skills are automatically validated against the Agent Skills Specification via GitHub Actions:
- ✅ Directory structure compliance
- ✅ Required SKILL.md frontmatter fields
- ✅ Naming conventions (lowercase, hyphens, no reserved words)
- ✅ Character limits (name ≤64 chars, description ≤1024 chars)
- ✅ Best practices (progressive disclosure, clear triggers)
Run validation locally:
python scripts/validate-spec.py skills/See CONTRIBUTING.md for detailed requirements.
cockroachdb-skills/
├── skills/ # All skills organized by domain
│ ├── onboarding-and-migrations/
│ ├── application-development/
│ ├── performance-and-scaling/
│ ├── operations-and-lifecycle/
│ ├── resilience-and-disaster-recovery/
│ ├── observability-and-diagnostics/
│ ├── security-and-governance/
│ ├── integrations-and-ecosystem/
│ └── cost-and-usage-management/
├── scripts/ # Validation and tooling scripts
│ ├── validate-spec.py # Specification compliance validator
│ └── requirements.txt # Python dependencies
├── .github/ # GitHub Actions and templates
│ ├── workflows/
│ │ └── validate-skills.yml # CI validation workflow
│ ├── ISSUE_TEMPLATE/ # Issue templates for proposals
│ └── PULL_REQUEST_TEMPLATE.md # PR template with checklist
├── CONTRIBUTING.md # Contribution guidelines
├── LICENSE # Apache 2.0 license
└── README.md # This file
This repository is licensed under the Apache License 2.0. See LICENSE for details.
Maintained by Cockroach Labs