Agent skill

TiDB Integration Test Recorder

by pingcap in pingcap/tidb

“Use when recording TiDB integration tests under tests/integrationtest and verifying regenerated result files stay minimal and correct.”

— description from SKILL.md by pingcap
Apache-2.0Auto-check passedTesting & QA

Install TiDB Integration Test Recorder

skills CLI
$ npx skills add pingcap/tidb --skill tidb-integrationtest-recorder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pingcap/tidb tidb-integrationtest-recorder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tidb-integrationtest-recorder .claude/skills/tidb-integrationtest-recorder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tidb-integrationtest-recorder
GitHub stars
41k
Token cost
~260 tokens
SKILL.md length
98 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 3 steps: Use docs/agents/testing-flow.md ->… → Derive TestName from the path under… → Review changed files in…
  • SKILL.md covers Overview, Workflow and Guardrails
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

TiDB Integration Test Recorder is a skill in pingcap/tidb (41k stars). Its SKILL.md is about 260 tokens. Licence: Apache-2.0.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Use docs/agents/testing-flow.md -> Integration tests (/tests/integrationtest) for the recording command.
  2. Derive TestName from the path under tests/integrationtest/t/ without the .test suffix (example: planner/core/binary_plan).
  3. Review changed files in tests/integrationtest/r/** and keep result diffs minimal.

What it can do on your machine

Read from SKILL.md and the folder at commit e39ff91. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

TiDB Integration Test Recorder loads about 260 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 98 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~260

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pingcap/tidb at commit e39ff91, republished under its Apache-2.0 licence (© pingcap). 98 words, ~260 tokens.

Download SKILL.mdSave it as .claude/skills/tidb-integrationtest-recorder/SKILL.md (or your agent's skills folder).
name
tidb-integrationtest-recorder
description
Use when recording TiDB integration tests under tests/integrationtest and verifying regenerated result files stay minimal and correct.

TiDB Integration Test Recorder

Overview

Use this workflow for changes under tests/integrationtest/t/** or when SQL behavior needs integration coverage. Do not use -record for this suite. Canonical command details live in docs/agents/testing-flow.md -> Integration tests (/tests/integrationtest).

Workflow

  1. Use docs/agents/testing-flow.md -> Integration tests (/tests/integrationtest) for the recording command.
  2. Derive TestName from the path under tests/integrationtest/t/ without the .test suffix (example: planner/core/binary_plan).
  3. Review changed files in tests/integrationtest/r/** and keep result diffs minimal.

Guardrails

  • Prefer targeted recording of the affected suite only.
  • Avoid unrelated result churn.
  • If result files need manual edits, keep them minimal and verify with another run.

© pingcap, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/tidb-integrationtest-recorder of pingcap/tidb.

Open the folder on GitHubat commit e39ff91

Compare with similar skills

TiDB Integration Test Recorder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

TiDB Integration Test Recorder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
TiDB Integration Test Recorder this skillpingcap/tidb41k—~260Automated safety check: PassApache-2.0
Pglock Integrationcirello-io/pglock122—~2.2kAutomated safety check: PassApache-2.0
512 Frameworks Micronaut Datajabrena/plinth446—~879Automated safety check: PassApache-2.0
Testcontainers Integration TestsAaronontheweb/dotnet-skills1.2k1 repos~1.8kAutomated safety check: PassMIT
Rust Sqlx Postgres Servicehashgraph-online/awesome-codex-plugins1.2k—~938Automated safety check: PassMIT
Database Testingpetrkindlmann/qa-skills165—~4.2kAutomated safety check: PassMIT

Similar skills

  • Pglock Integration

    cirello-io/pglock

    A skill your agent uses when building or modifying a Go application that uses cirello.io/pglock for PostgreSQL-backed distributed locks, per-resource mutual exclusion, leader election, leases…

    122 GitHub stars~2.2k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • A skill your agent uses when you need data access with Micronaut Data — @MappedEntity, CrudRepository/PageableRepository, @Query with parameters, @Transactional services, projections, @Version, and…

    446 GitHub stars~879 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Testcontainers Integration Tests

    Aaronontheweb/dotnet-skills

    Write integration tests using TestContainers for .NET with xUnit.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Testing & QAAuto-check passed
  • Rust Sqlx Postgres Service

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or reviewing Postgres persistence in Rust services that use sqlx, especially when designing migrations, query!

    1.2k GitHub stars~938 tokensUpdated today
    Testing & QAAuto-check passed
  • Database Testing

    petrkindlmann/qa-skills

    Validate database integrity, test migrations forward and backward, verify schema constraints, manage seed data, detect migration drift, and identify query performance issues.

    165 GitHub stars~4.2k tokensUpdated 4 mo ago
    DatabasesAuto-check passed
  • Go CLI SQL Storage

    hashgraph-online/awesome-codex-plugins

    Design, implement, test, and ship SQL-backed persistence for Go CLIs using database/sql, explicit pool ownership, bounded startup checks, embedded migrations, transaction boundaries, parameterized…

    1.2k GitHub stars~801 tokensUpdated today
    DatabasesAuto-check passed

More from pingcap/tidb

All 9 skills in this repo
  • Decides from local git changes whether make bazel_prepare must run in TiDB before build or test commands, and reports the evidence for the decision.

    41k GitHub stars~408 tokensUpdated today
    Auto-check passed
  • Investigates TiDB plan or test-result diffs that the change does not explain, ruling out failpoint setup and merge effects before expected outputs are updated.

    41k GitHub stars~498 tokensUpdated today
    Auto-check passed
  • Use when running TiDB package tests and deciding whether failpoint enable/disable is required before and after the test command.

    41k GitHub stars~256 tokensUpdated today
    Auto-check passed
  • Use when running tests under tests/realtikvtest that require a local TiUP playground lifecycle with strict startup, readiness checks, and cleanup.

    41k GitHub stars~250 tokensUpdated today
    Auto-check passed
  • Checks a fix proposed by a user or reviewer for intent, correctness and compatibility before the agent implements it in the TiDB codebase.

    41k GitHub stars~523 tokensUpdated today
    Auto-check passed
  • Keeps TiDB GitHub issues consistent by following the issue templates, writing reproducible reports, checking for duplicates and applying labels explicitly.

    41k GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about TiDB Integration Test Recorder

How do I install TiDB Integration Test Recorder in Claude Code?

Run `npx skills add pingcap/tidb --skill tidb-integrationtest-recorder -a claude-code`. Or copy the skill folder (.agents/skills/tidb-integrationtest-recorder in pingcap/tidb) into .claude/skills/tidb-integrationtest-recorder in your project. Claude Code loads it when a task matches its description.

How do I install TiDB Integration Test Recorder in Codex?

Run `npx skills add pingcap/tidb --skill tidb-integrationtest-recorder -a codex`. Or copy the skill folder (.agents/skills/tidb-integrationtest-recorder in pingcap/tidb) into .agents/skills/tidb-integrationtest-recorder in your project. Codex loads it when a task matches its description.

Can I use TiDB Integration Test Recorder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pingcap/tidb --skill tidb-integrationtest-recorder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tidb-integrationtest-recorder, .gemini/skills/tidb-integrationtest-recorder, .github/skills/tidb-integrationtest-recorder and .opencode/skills/tidb-integrationtest-recorder in your project.

What does TiDB Integration Test Recorder need to run?

SKILL.md names no scripts, command-line tools or credentials: TiDB Integration Test Recorder is instructions for the agent only.

Does TiDB Integration Test Recorder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is TiDB Integration Test Recorder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does TiDB Integration Test Recorder use?

TiDB Integration Test Recorder is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does TiDB Integration Test Recorder use?

About 260 tokens (SKILL.md is roughly 1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to TiDB Integration Test Recorder?

Skills that share tags, products or a category with TiDB Integration Test Recorder: Pglock Integration (cirello-io/pglock, 122 stars), 512 Frameworks Micronaut Data (jabrena/plinth, 446 stars), Testcontainers Integration Tests (Aaronontheweb/dotnet-skills, 1.2k stars) and Rust Sqlx Postgres Service (hashgraph-online/awesome-codex-plugins, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains TiDB Integration Test Recorder?

pingcap (a GitHub organization) maintains it in pingcap/tidb, which has 40,632 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 8, 2026.

Source: pingcap/tidb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.