SKILL.md

April 15, 2026 ยท View on GitHub

Usage

All scripts can be executed using Node.js. Replace <param_name> and <param_value> with actual values.

Bash: node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'

PowerShell: node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'

Note: The scripts automatically load the environment variables from various .env files. Do not ask the user to set vars unless skill executions fails due to env var absence.

Scripts

execute_sql

Use this skill to execute SQL.

Parameters

NameTypeDescriptionRequiredDefault
sqlstringThe sql to execute.Yes

get_query_plan

Provide information about how MySQL executes a SQL statement. Common use cases include: 1) analyze query plan to improve its performance, and 2) determine effectiveness of existing indexes and evalueate new ones.

Parameters

NameTypeDescriptionRequiredDefault
sql_statementstringThe sql statement to explain.Yes

list_active_queries

Lists top N (default 10) ongoing queries from processlist and innodb_trx, ordered by execution time in descending order. Returns detailed information of those queries in json format, including process id, query, transaction duration, transaction wait duration, process time, transaction state, process state, username with host, transaction rows locked, transaction rows modified, and db schema.

Parameters

NameTypeDescriptionRequiredDefault
min_duration_secsintegerOptional: Only show queries running for at least this long in secondsNo0
limitintegerOptional: The maximum number of rows to return.No100

list_tables

Lists detailed schema information (object type, columns, constraints, indexes, triggers, comment) as JSON for user-created tables (ordinary or partitioned). Filters by a comma-separated list of names. If names are omitted, lists all tables in user schemas.

Parameters

NameTypeDescriptionRequiredDefault
table_namesstringOptional: A comma-separated list of table names. If empty, details for all tables will be listed.No``
output_formatstringOptional: Use 'simple' for names only or 'detailed' for full info.Nodetailed