Agent skill

MySQL and MariaDB Query Tool

by evolution-foundation in evolution-foundation/evo-nexus

Queries MySQL or MariaDB databases declared in .env by label, read-only by default unless a connection explicitly allows writes.

Custom licenceAuto-check: notesDatabases

Install MySQL and MariaDB Query Tool

skills CLI
$ npx skills add evolution-foundation/evo-nexus --skill db-mysql -a claude-code

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

GitHub CLI
$ gh skill install evolution-foundation/evo-nexus db-mysql --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/evolution-foundation/evo-nexus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/db-mysql .claude/skills/db-mysql && 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
db-mysql
GitHub stars
544
Token cost
~1.9k tokens
SKILL.md length
427 words
Files
2 (incl. scripts)
Skills in repo
117
Repo updated
First seen
Licence
Custom licence

At a glance

Queries MySQL or MariaDB databases declared in .env by label, read-only by default unless a connection explicitly allows writes.

  • Works in 4 steps: If the user doesn't specify a label, run… → Write the smallest SQL that answers the… → Run via query. Inspect the result. → …
  • Exploring tables and schema in a configured MySQL or MariaDB database
  • SKILL.md covers Setup — one-time, per database, Usage, Output shape and Guardrails, plus 3 more sections
  • Runs Python scripts from its folder; calls python3 and uv; needs DB_MYSQL_1_PASSWORD

What it does

One or more DB_MYSQL_N_* blocks in a project's .env file get read, each labelled for a specific database such as an orders or analytics instance, and the right connection is picked by label or numeric index at call time. A bundled Python script lists configured connections, health-checks one, runs a read-only query, or explores tables and schema, always as a single JSON line on stdout.

Writes are refused unless the matching connection block sets ALLOW_WRITE=true, and a result that exceeds a row cap is truncated with the full result saved to a CSV log file instead of being re-run. Errors come back as structured JSON with a specific code, such as a missing label, a missing driver, or a blocked write.

When your agent uses it

  • Exploring tables and schema in a configured MySQL or MariaDB database
  • Running a read-only ad hoc query against a labelled database connection
  • Auditing recent data in a specific environment without write access

Example prompts

  • “List the tables in the orders-dev database connection.”
  • “Run a count of customers created in the last 7 days against analytics-prod.”
  • “Health-check every MySQL connection configured in .env.”

Requirements

  • Python 3 with `pymysql`
  • DB_MYSQL_N_* connection blocks in .env

Workflow steps

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

  1. If the user doesn't specify a label, run accounts to see what's configured and pick the one that matches their intent. If ambiguous, ask.
  2. Write the smallest SQL that answers the question — prefer aggregates, LIMIT, and EXPLAIN before dumping rows.
  3. Run via query. Inspect the result.
  4. For performance-sensitive queries, load the deep-dive references below.

What it can do on your machine

Read from SKILL.md and the folder at commit 7f5dd76. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • uv

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

  • Network

    Links to these hosts (documentation or services it may open):

    • raw.githubusercontent.com
    • github.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DB_MYSQL_1_PASSWORD

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

Context cost

MySQL and MariaDB Query Tool loads about 1.9k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 427 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:3
    MySQL / MariaDB databases configured in .env (DB_MYSQL_N_*). Use when the user asks to query, explore, or audit data in
  • NoteMentions a .env fileSKILL.md:19
    y MySQL / MariaDB databases declared in `.env`. Connections follow the same numbered pattern as `SOCIAL_YOUTUBE_N_*` / `
  • NoteMentions a .env fileSKILL.md:23
    Add a block to `.env` (gitignored). Increment the index per connection:
  • NoteMentions a .env fileSKILL.md:32
    SQL_1_PASSWORD=...                # raw; .env is gitignored
  • NoteMentions a .env fileSKILL.md:104
    nections` — no `DB_MYSQL_N_*` blocks in `.env`

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 427 words (~1,942 tokens).

“Query MySQL / MariaDB databases declared in .env. Connections follow the same numbered pattern as SOCIAL_YOUTUBE_N_* / SOCIAL_INSTAGRAM_N_* — one block per database, labelled for humans, picked by label or index at call time.”

— opening of SKILL.md by evolution-foundation, Custom licence
name
db-mysql

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .claude/skills/db-mysql of evolution-foundation/evo-nexus.

  • SKILL.md
  • scripts/db_client.py

Open the folder on GitHubat commit 7f5dd76

Compare with similar skills

MySQL and MariaDB Query Tool 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.

MySQL and MariaDB Query Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MySQL and MariaDB Query Tool this skillevolution-foundation/evo-nexus544—~1.9kAutomated safety check: NotesCustom licence
Mysqlericrisco/rsc-harness156—~3.7kAutomated safety check: PassMIT
Golang Databaseunxed/f42402 repos~2.9kAutomated safety check: PassMIT
Whodbxiaoyuge886/aigc198—~894Automated safety check: PassMIT
Mysqlsickn33/agentic-awesome-skills47k2 repos~2.7kAutomated safety check: NotesMIT
Matlab Use Databasematlab/matlab-agentic-toolkit1.1k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • Mysql

    ericrisco/rsc-harness

    A skill your agent uses when designing, querying, indexing or operating a MySQL or MariaDB database and engine-specific behaviour matters — schema and type choices, index design, reading EXPLAIN…

    156 GitHub stars~3.7k tokensUpdated today
    DatabasesAuto-check passed
  • Comprehensive guide for Go database access — parameterized queries, struct scanning, NULLable columns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context…

    240 GitHub starsUsed in 2 repos~2.9k tokens
    DatabasesAuto-check passed
  • Whodb

    xiaoyuge886/aigc

    Database operations including querying, schema exploration, and data analysis.

    198 GitHub stars~894 tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • Mysql

    sickn33/agentic-awesome-skills

    Administer MySQL/MariaDB databases. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.7k tokens
    DatabasesAuto-check: notes
  • Matlab Use Database

    matlab/matlab-agentic-toolkit

    Reads from, writes to, and manages relational databases using MATLAB Database Toolbox.

    1.1k GitHub stars~3.1k tokensUpdated 7 days ago
    DatabasesAuto-check passed
  • Tsh SQL And Database Understanding

    TheSoftwareHouse/copilot-collections

    SQL writing and database engineering patterns, standards, and procedures.

    284 GitHub stars~11k tokensUpdated 2 days ago
    DatabasesAuto-check passed

More from evolution-foundation/evo-nexus

All 117 skills in this repo
  • AI Image Creator

    evolution-foundation/evo-nexus

    Generates PNG images through OpenRouter models, with transparent backgrounds and reference-image edits, and describes existing images with multimodal vision.

    544 GitHub stars~5.1k tokensUpdated 4 mo ago
    Auto-check: notes
  • MongoDB Query Client

    evolution-foundation/evo-nexus

    Runs read-only MongoDB finds, aggregations and collection listings against databases named in your .env, choosing the connection by label or index.

    544 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check: notes
  • Postgres Query Client

    evolution-foundation/evo-nexus

    Runs read-only SQL queries and schema exploration against PostgreSQL databases declared in .env, chosen by label or index, with writes blocked unless a connection allows them.

    544 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check: notes
  • Redis Inspector

    evolution-foundation/evo-nexus

    Reads keys and server state from Redis instances configured in .env through a read-only Python client, choosing connections by label or index.

    544 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check: notes
  • Int Bling

    evolution-foundation/evo-nexus

    Bling ERP integration via API v3. An agent skill from evolution-foundation/evo-nexus.

    544 GitHub stars~2.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Int Evo CRM

    evolution-foundation/evo-nexus

    Query and manage Evo AI CRM data via REST API. An agent skill from evolution-foundation/evo-nexus.

    544 GitHub stars~2k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about MySQL and MariaDB Query Tool

What does MySQL and MariaDB Query Tool do?

Queries MySQL or MariaDB databases declared in .env by label, read-only by default unless a connection explicitly allows writes. env file get read, each labelled for a specific database such as an orders or analytics instance, and the right connection is picked by label or numeric index at call time. A bundled Python script lists configured connections, health-checks one, runs a read-only query, or explores tables and schema, always as a single JSON line on stdout.

When should I use MySQL and MariaDB Query Tool?

MySQL and MariaDB Query Tool fits situations like: exploring tables and schema in a configured MySQL or MariaDB database; running a read-only ad hoc query against a labelled database connection; auditing recent data in a specific environment without write access.

How do I install MySQL and MariaDB Query Tool in Claude Code?

Run `npx skills add evolution-foundation/evo-nexus --skill db-mysql -a claude-code`. Or copy the skill folder (.claude/skills/db-mysql in evolution-foundation/evo-nexus) into .claude/skills/db-mysql in your project. Claude Code loads it when a task matches its description.

How do I install MySQL and MariaDB Query Tool in Codex?

Run `npx skills add evolution-foundation/evo-nexus --skill db-mysql -a codex`. Or copy the skill folder (.claude/skills/db-mysql in evolution-foundation/evo-nexus) into .agents/skills/db-mysql in your project. Codex loads it when a task matches its description.

Can I use MySQL and MariaDB Query Tool 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 evolution-foundation/evo-nexus --skill db-mysql -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/db-mysql, .gemini/skills/db-mysql, .github/skills/db-mysql and .opencode/skills/db-mysql in your project.

What does MySQL and MariaDB Query Tool need to run?

Going by SKILL.md and its folder, MySQL and MariaDB Query Tool needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and uv) and credentials named DB_MYSQL_1_PASSWORD. Our summary lists: Python 3 with `pymysql`; DB_MYSQL_N_* connection blocks in .env.

Does MySQL and MariaDB Query Tool access the network?

SKILL.md names 2 domains. As links in the text: raw.githubusercontent.com and github.com. This is read from the text; nothing was executed.

Is MySQL and MariaDB Query Tool safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does MySQL and MariaDB Query Tool use?

MySQL and MariaDB Query Tool has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does MySQL and MariaDB Query Tool use?

About 1.9k tokens (SKILL.md is roughly 7.8k 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 MySQL and MariaDB Query Tool?

Skills that share tags, products or a category with MySQL and MariaDB Query Tool: Mysql (ericrisco/rsc-harness, 156 stars), Golang Database (unxed/f4, 240 stars), Whodb (xiaoyuge886/aigc, 198 stars) and Mysql (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MySQL and MariaDB Query Tool?

evolution-foundation (a GitHub organization) maintains it in evolution-foundation/evo-nexus, which has 544 GitHub stars. The repository holds 117 skills in this directory. The repository was last updated on May 13, 2026.

Source: evolution-foundation/evo-nexus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.