pingcapOfficial·10 Agent Skills Included

tidb

AI agent workflows for building and testing the TiDB database

Guides AI agents through safe code changes, testing, and pull requests in the TiDB distributed SQL database codebase. Eliminates guesswork around Bazel builds, failpoint tests, integration test recording, and PR or issue metadata rules. Helps contributors and agents pick the right validation scope, triage test failures, and ship verified changes faster.

40,478|6,233

↗

npx skills add pingcap/tidb --all -g -y

Available:

Gives the AI agent repository-wide rules for making TiDB code changes, including when to run Bazel preparation, which tests to run for each subsystem, and how to verify work before claiming completion.

All Skills in This Repository (10)

Pure Emerald Level Indicators

📦 In Repo

pingcap

tidb-test-guidelines

Provide guidelines for writing and placing tests in the TiDB codebase.

tidb-test-diff-triage

Diagnose unexpected TiDB test diffs by ruling out failpoint setup and bisecting merged commits.

tidb-issue-metadata-guard

Standardizes TiDB GitHub issue creation and editing with templates, labels, and structured descriptions.

tidb-failpoint-test-runner

Determines failpoint enablement requirements before running TiDB package tests.

tidb-realtikv-runner

Runs TiDB realtikvtest suites against a local TiUP playground with readiness checks and cleanup.

tidb-verify-profile

Selects appropriate local validation scope for TiDB code changes using tiered verification profiles.

tidb-pr-metadata-guard

Preserves TiDB pull request template structure while editing mutable PR metadata fields.

tidb-integrationtest-recorder

Records TiDB integration test results and keeps regenerated result diffs minimal.

tidb-change-instruction-critic

Validates prescribed code change instructions against TiDB correctness and compatibility constraints before implementation.

tidb-bazel-prepare-gate

Determines whether make bazel_prepare is required before TiDB build or test commands.

Official

Basic

Frequently Asked Questions

FAQPage Schema

How to install TiDB agent skills?▼

Run `npx skills add pingcap/tidb --all -g -y` in your terminal to install all skills in this suite globally.

What do the TiDB agent skills do?▼

They teach your AI agent how to build, test, and submit changes to the TiDB database correctly, covering Bazel builds, failpoint tests, and PR metadata rules.

How do agents decide which TiDB tests to run?▼

The skills map each changed code path to the smallest required test set, so the agent runs targeted unit or integration tests instead of slow full-suite runs.

Do these skills work with Claude Code and other agents?▼

Yes. They follow the standard SKILL.md format and work in Claude Code, OpenClaw, Cursor, and other compatible AI coding agents.

Can agents create TiDB pull requests automatically?▼

Yes. Dedicated skills keep PR titles, templates, labels, and linked issues consistent with TiDB repository requirements when the agent creates or edits PRs.