OceanBase Skills
A collection of AI Agent Skills for OceanBase products — designed for use with Claude Code, Cursor, Windsurf, and any other agent that supports the Agent Skills Specification.
Each skill is a self-contained directory with a SKILL.md file (plus optional references/) that gives AI agents the domain knowledge needed to help you operate OceanBase products correctly and safely.
Available Skills
oceanbase-deploy — OceanBase Deployment & Operations (via obd)
| Skill | Description |
|---|
oceanbase-deploy | Overview & routing — start here if unsure which skill to use |
cluster-management | Cluster lifecycle: deploy, start, stop, upgrade, scale out, OCP CE takeover, monitoring |
tenant-management | Tenant CRUD, backup, restore, workload optimization |
seekdb (obd) | obd-managed SeekDB: primary-standby HA (switchover / failover / decouple) |
testing-and-benchmark | Sysbench, TPC-H, TPC-C, mysqltest benchmarks |
seekdb — SeekDB Full Lifecycle Skills (install / build / docs / CLI / import / query)
| Skill | Description |
|---|
seekdb | Overview & routing for standalone SeekDB |
seekdb/install | Install/deploy SeekDB via Homebrew, Docker, yum, apt, pip, Windows MSI |
seekdb/build | Build SeekDB from source for macOS, Linux, Android, Windows, Python wheel |
seekdb/docs | Documentation search — SQL syntax, vector/hybrid search, SDK, integration, deployment; ~1000 doc catalog entries |
seekdb/cli | seekdb-cli — SQL / schema / table data profiling / vector collections / AI models, all JSON output, AI-Agent friendly |
seekdb/importing | Import CSV/Excel data into SeekDB, with per-column vectorization |
seekdb/querying | Query/export — scalar filters, hybrid search (full-text + semantic), export results to CSV/Excel |
More skills are on the way. Planned areas include OceanBase kernel tuning, SQL diagnostics, migration, and more.
Quick Start
Install via skills.sh (recommended)
# Install the oceanbase-deploy skill (includes all sub-skills)
npx skills add oceanbase/oceanbase-skills --skill oceanbase-deploy
# Install the seekdb standalone skill (install / build from source)
npx skills add oceanbase/oceanbase-skills --skill seekdb
# Or install all skills from this repo
npx skills add oceanbase/oceanbase-skills
Manual install — Claude Code
mkdir -p .claude/skills/oceanbase-deploy
curl -sL "https://raw.githubusercontent.com/oceanbase/oceanbase-skills/main/skills/oceanbase-deploy/SKILL.md" \
-o .claude/skills/oceanbase-deploy/SKILL.md
for s in cluster-management tenant-management seekdb testing-and-benchmark; do
mkdir -p .claude/skills/oceanbase-deploy/$s
curl -sL "https://raw.githubusercontent.com/oceanbase/oceanbase-skills/main/skills/oceanbase-deploy/$s/SKILL.md" \
-o .claude/skills/oceanbase-deploy/$s/SKILL.md
done
# SeekDB skill bundle (install + build + docs + cli + importing + querying)
mkdir -p .claude/skills/seekdb
curl -sL "https://raw.githubusercontent.com/oceanbase/oceanbase-skills/main/skills/seekdb/SKILL.md" \
-o .claude/skills/seekdb/SKILL.md
for s in install build docs cli importing querying; do
mkdir -p .claude/skills/seekdb/$s
curl -sL "https://raw.githubusercontent.com/oceanbase/oceanbase-skills/main/skills/seekdb/$s/SKILL.md" \
-o .claude/skills/seekdb/$s/SKILL.md
done
Load a single skill from GitHub URL
https://raw.githubusercontent.com/oceanbase/oceanbase-skills/main/skills/oceanbase-deploy/<skill-name>/SKILL.md
Agent Integration
Claude Code / Cursor / Windsurf (via skills.sh)
npx skills add oceanbase/oceanbase-skills --skill oceanbase-deploy
npx skills add automatically detects your IDE (Claude Code, Cursor, Windsurf, etc.) and installs to the right directory.
Claude Code (manual)
Use the curl commands in Quick Start above, or manually place SKILL.md files into .claude/skills/oceanbase-deploy/.
Other Agents
- System prompt / rules file: paste the content of
SKILL.md.
- URL-based loading: use the raw GitHub link above.
- In-conversation context: paste the
SKILL.md content at the start of your session.
Example Prompts
After loading the skills, ask your agent for concrete tasks. Below are examples grouped by skill.
Cluster Management
Deploy a local OceanBase community edition — just get it running quickly
