Home  /  Integrations  /  Skill

PlasmidDB Skill v0.1.0

A drop-in skill for Kimi CLI and other Claude-compatible skill runners. Lets the agent query PlasmidDB's plasmid, feature, and variant APIs using your personal token — read-only for regular users, full CRUD for superuser / staff tokens.

Download zip
plasmiddb-skill.zip
Create a personal API token first: Sign in, then open Profile → API tokens → New token. Any authenticated token can read; only superuser / staff tokens can create, update, or delete records.

Install in Kimi CLI & Cherry Studio

The skill ships as a single zip. Unpack it into your tool's skill directory, set two environment variables, and you're done.

Kimi CLI

skill format
  1. Download plasmiddb-skill.zip using the button above.
  2. Extract into Kimi's skills dir (typically ~/.kimi/skills/):
mkdir -p ~/.kimi/skills
unzip plasmiddb-skill.zip -d ~/.kimi/skills/

Export your token & base URL:

export PLASMIDDB_TOKEN="<your-token>"
export PLASMIDDB_BASE_URL="https://addgene.mtc-lab.cn"

Restart Kimi CLI. The skill auto-loads when the description matches (e.g. "look up plasmid 99530", "list reporter features").

Cherry Studio

custom agent

Cherry Studio doesn't load Claude-style skills natively, but the skill's Python helper can be wired up as a Custom Agent / tool call:

  1. Extract the zip anywhere, e.g. ~/.plasmiddb-skill/.
  2. In Cherry Studio open Settings → Agents → Custom, add a new agent with this system prompt:
You have a CLI `plasmiddb` that hits the PlasmidDB REST API.
Use it to search and read plasmids, features, and variants.
Run e.g.  python ~/.plasmiddb-skill/plasmiddb-skill/scripts/plasmiddb_api.py plasmid list --search Cas9
Honor the user's PLASMIDDB_TOKEN / PLASMIDDB_BASE_URL env.

For a first-class native integration, use the MCP server — Cherry Studio supports MCP directly.

What the skill does

CommandDoes what
plasmid listSearch / paginate plasmids — filters: species, expression_type, depositor, topology, search, ordering.
plasmid get <id>Fetch one plasmid by its plasmid_id.
feature listList / filter features. Filters: type, category, gene, plus search/ordering.
feature get <id>Fetch one feature by feature_id.
variant listList variants. Filter by feature, plasmid, strand.
variant get <id>Fetch one variant by variant_id.
{resource} create / update / deleteSuperuser only. Write operations; non-privileged tokens get HTTP 403.

Raw curl (if you don't want the zip)

curl -H "Authorization: Token $PLASMIDDB_TOKEN" \
     "https://addgene.mtc-lab.cn/api/v1/plasmids/?search=Cas9"