Agent skills for SelectDB Cloud control plane

An agent skill for SelectDB Cloud control-plane operations, driven by sdbcli (the cloud-cli control-plane binary). It uses the portable Agent Skills (SKILL.md) format, so it works with most mainstream coding agents — Claude Code, Cursor, Codex, opencode, and others.

This repository contains a single skill, selectdb-cloud. It depends only on sdbcli and has no dependency on any other skill or shared kernel.

Scope

selectdb-cloud covers the control plane of SelectDB Cloud:

• Auth / environment setup (sdbcli auth, sdbcli cloud use / ctx)
• Warehouse and cluster lifecycle (list, get, create, resize, pause/resume/reboot, delete)
• Networking (public-access policy, PrivateLink inbound/outbound)
• Billing summaries/details and audit logs
• Resolving a cluster's data-plane endpoint for handoff (sdbcli cloud endpoint)
• Troubleshooting control-plane errors

It is control-plane only: it does not run SQL or cover queries / table design. The data plane is reached by resolving the cluster endpoint and handing the address off to a separate data-plane client — that work is out of scope here.

Prerequisites

This skill drives the sdbcli binary. Install it with npm:

npm install -g @selectdb/sdbcli
sdbcli --version

Or build it from the cloud-cli repo and put it on your PATH:

# in the cloud-cli repo
cargo build --release
# then put target/release/sdbcli on your PATH
sdbcli --version

sdbcli talks to the SelectDB Cloud Management API with an API key (X-API-Key) and requires an explicit --api-host (e.g. api.selectdb.com). Config lives under ~/.sdbcli/; all environment variables use the CLOUD_ prefix.

Install

Install with the skills CLI — no clone needed:

# globally, available in every project:
npx skills add selectdb/selectdb-cloud-skills -g

# or project-local, just for the current repo:
npx skills add selectdb/selectdb-cloud-skills

The CLI auto-detects the coding agents you have installed and installs the selectdb-cloud skill for them; your agent picks it up on its next session. Pass -a <agent> to target one explicitly — e.g. -a claude-code, -a cursor, or -a codex.

If sdbcli is not on your PATH, the skill still works as a workflow reference and tells you how to build it (see Prerequisites above).

Uninstall

npx skills remove selectdb-cloud        # add --global if you installed with -g

Layout

selectdb-cloud-skills/
├── README.md
└── skills/
    └── selectdb-cloud/
        ├── SKILL.md
        └── references/
            ├── onboarding.md
            ├── context.md
            ├── cluster-lifecycle.md
            ├── networking.md
            ├── billing-and-audit.md
            └── troubleshooting.md

License

Apache-2.0