MongoDB Source Connector E2E Harness
airbytehq/airbyte
Starts a throwaway MongoDB 7.0 replica set and runs the Airbyte spec, check, discover and read commands against source-mongodb-v2 images for local end-to-end testing.
“Use when running tests under tests/realtikvtest that require a local TiUP playground lifecycle with strict startup, readiness checks, and cleanup.”
Install TiDB RealTiKV Test Runner
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pingcap/tidb tidb-realtikv-runner --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .claude/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.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/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .claude/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runnerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pingcap/tidb tidb-realtikv-runner --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .agents/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .agents/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pingcap/tidb tidb-realtikv-runner --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .cursor/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .cursor/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pingcap/tidb.git --path .agents/skills/tidb-realtikv-runner--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pingcap/tidb tidb-realtikv-runner --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .gemini/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .gemini/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pingcap/tidb tidb-realtikv-runnerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .github/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .github/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pingcap/tidb --skill tidb-realtikv-runner -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pingcap/tidb tidb-realtikv-runner --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pingcap/tidb.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/tidb-realtikv-runner .opencode/skills/tidb-realtikv-runner && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tidb-realtikv-runner" agent skill from https://github.com/pingcap/tidb/tree/master/.agents/skills/tidb-realtikv-runner into .opencode/skills/tidb-realtikv-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidb-realtikv-runner", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tidb-realtikv-runner- GitHub stars
- 41k
- Token cost
- ~250 tokens
- SKILL.md length
- 100 words
- Files
- 1
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
- Works in 5 steps: Choose the standard flow or Cleanup-safe… → Use default PD_ADDR=127.0.0.1:2379… → Keep the test scope narrow (-run and… → …
- SKILL.md covers Overview and Workflow Checklist
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
About this skill
TiDB RealTiKV Test Runner is a skill in pingcap/tidb (41k stars). Its SKILL.md is about 250 tokens. Licence: Apache-2.0.
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Choose the standard flow or Cleanup-safe template from docs/agents/testing-flow.md -> RealTiKV tests (/tests/realtikvtest).
- Use default PD_ADDR=127.0.0.1:2379 unless a port conflict requires --pd.port or --port-offset.
- Keep the test scope narrow (-run and target subdir only).
- If failpoints are needed, enable before tests and disable afterward.
- Verify teardown by confirming the PD endpoint is unreachable after cleanup.
What it can do on your machine
Read from SKILL.md and the folder at commit 77bf7cb. 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 RealTiKV Test Runner loads about 250 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 100 words of instructions outside code blocks.
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 77bf7cb, republished under its Apache-2.0 licence (© pingcap). 100 words, ~250 tokens.
Download SKILL.mdSave it as
.claude/skills/tidb-realtikv-runner/SKILL.md (or your agent's skills folder).- name
- tidb-realtikv-runner
- description
- Use when running tests under tests/realtikvtest that require a local TiUP playground lifecycle with strict startup, readiness checks, and cleanup.
TiDB RealTiKV Runner
Overview
Use this skill for test targets under tests/realtikvtest/**.
Always start playground in the background, verify readiness, run scoped tests, then clean up process and data.
Canonical command details live in docs/agents/testing-flow.md -> RealTiKV tests (/tests/realtikvtest).
Workflow Checklist
- Choose the standard flow or
Cleanup-safe templatefromdocs/agents/testing-flow.md->RealTiKV tests (/tests/realtikvtest). - Use default
PD_ADDR=127.0.0.1:2379unless a port conflict requires--pd.portor--port-offset. - Keep the test scope narrow (
-run <TestName>and target subdir only). - If failpoints are needed, enable before tests and disable afterward.
- Verify teardown by confirming the PD endpoint is unreachable after cleanup.
© 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-realtikv-runner of pingcap/tidb.
Open the folder on GitHubat commit 77bf7cb
Compare with similar skills
TiDB RealTiKV Test Runner 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| TiDB RealTiKV Test Runner this skillpingcap/tidb | 41k | — | ~250 | Automated safety check: Pass | Apache-2.0 | |
| MongoDB Source Connector E2E Harnessairbytehq/airbyte | 22k | — | ~1.9k | Automated safety check: Pass | Custom licence | |
| Go Redis Client Test Runnerredis/go-redis | 22k | — | ~786 | Automated safety check: Pass | BSD-2-Clause | |
| Airbyte Postgres Source E2E Testsairbytehq/airbyte | 22k | — | ~2.5k | Automated safety check: Pass | Custom licence | |
| Pglock Integrationcirello-io/pglock | 123 | — | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| Source MySQL CDC Test Harnessairbytehq/airbyte | 22k | — | ~1.8k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
- Official
Go Redis Client Test Runner
redis/go-redis
Explains how to run go-redis tests: the Docker Compose stack, make targets, focusing a single Ginkgo spec, the e2e suite and the version environment variables.
- Official
Airbyte Postgres Source E2E Tests
airbytehq/airbyte
Starts a local PostgreSQL 16 container, loads SQL fixtures and runs the Airbyte spec, check, discover and read commands against a chosen source-postgres image.
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…
- Official
Source MySQL CDC Test Harness
airbytehq/airbyte
Reproduces MySQL binlog change-data-capture behavior for the Airbyte source-mysql connector on a local MySQL backend, with fixtures, a catalog and smoke cases.
- Official
Postgres CDC E2E Test Harness
airbytehq/airbyte
Reproduces PostgreSQL logical-decoding CDC behavior for Airbyte's source-postgres connector on a local backend, with CDC fixtures, a catalog and smoke case scripts.
More from pingcap/tidb
All 9 skills in this repoTiDB Bazel Prepare Gate
pingcap/tidb
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.
TiDB Test Diff Triage
pingcap/tidb
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.
TiDB Failpoint Test Runner
pingcap/tidb
Use when running TiDB package tests and deciding whether failpoint enable/disable is required before and after the test command.
TiDB Integration Test Recorder
pingcap/tidb
Use when recording TiDB integration tests under tests/integrationtest and verifying regenerated result files stay minimal and correct.
TiDB Change Instruction Critic
pingcap/tidb
Checks a fix proposed by a user or reviewer for intent, correctness and compatibility before the agent implements it in the TiDB codebase.
TiDB Issue Metadata Guard
pingcap/tidb
Keeps TiDB GitHub issues consistent by following the issue templates, writing reproducible reports, checking for duplicates and applying labels explicitly.
Related
Works with
Categories
Questions about TiDB RealTiKV Test Runner
How do I install TiDB RealTiKV Test Runner in Claude Code?
Run `npx skills add pingcap/tidb --skill tidb-realtikv-runner -a claude-code`. Or copy the skill folder (.agents/skills/tidb-realtikv-runner in pingcap/tidb) into .claude/skills/tidb-realtikv-runner in your project. Claude Code loads it when a task matches its description.
How do I install TiDB RealTiKV Test Runner in Codex?
Run `npx skills add pingcap/tidb --skill tidb-realtikv-runner -a codex`. Or copy the skill folder (.agents/skills/tidb-realtikv-runner in pingcap/tidb) into .agents/skills/tidb-realtikv-runner in your project. Codex loads it when a task matches its description.
Can I use TiDB RealTiKV Test Runner 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-realtikv-runner -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-realtikv-runner, .gemini/skills/tidb-realtikv-runner, .github/skills/tidb-realtikv-runner and .opencode/skills/tidb-realtikv-runner in your project.
What does TiDB RealTiKV Test Runner need to run?
SKILL.md names no scripts, command-line tools or credentials: TiDB RealTiKV Test Runner is instructions for the agent only.
Does TiDB RealTiKV Test Runner 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 RealTiKV Test Runner 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 RealTiKV Test Runner use?
TiDB RealTiKV Test Runner 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 RealTiKV Test Runner use?
About 250 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 RealTiKV Test Runner?
Skills that share tags, products or a category with TiDB RealTiKV Test Runner: MongoDB Source Connector E2E Harness (airbytehq/airbyte, 22k stars), Go Redis Client Test Runner (redis/go-redis, 22k stars), Airbyte Postgres Source E2E Tests (airbytehq/airbyte, 22k stars) and Pglock Integration (cirello-io/pglock, 123 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TiDB RealTiKV Test Runner?
pingcap (a GitHub organization) maintains it in pingcap/tidb, which has 40,630 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 10, 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.