Skill registry
Developer workflowsPublic skills

Database Operations

Safe database operations for AI agents — schema inspection, read-only querying, performance analysis, governed migrations, and data exploration via Supabase, PlanetScale, Neon, or any SQL database.

What this skill teaches

A reusable playbook for a specific kind of work.

An MCP server tells an agent which actions are available. A skill adds the judgment around those actions: how to recognize the job, which sequence to follow, what to avoid, and how to decide that the result is complete.

Orchestrate database operations — inspect schemas, query data safely, analyze performance, manage migrations, and explore data patterns. Use when querying databases, inspecting table schemas, analyzing slow queries, running migrations, checking index usage, or exploring data distributions.

Architecture

How Database Operations guides an ADK-Rust agent.

The skill stays readable and portable because it contains instructions rather than service credentials or business data. ADK-Rust supplies it to the agent, the agent chooses from its reviewed tool boundary, and the connected MCP server performs the authenticated operation.

01

User request

The agent receives a goal expressed in ordinary language.

02

Database Operations skill

Matches intent, supplies the decision guide, and narrows the tool boundary.

03

ADK-Rust agent

Plans the workflow and streams each meaningful step through the runtime.

04

mcp-database

Executes authenticated operations against the system that owns the capability.

05

Verified result

The skill's completion rules shape the evidence returned to the user.

Portable instructions: SKILL.md · Capability boundary: mcp-database · Allowed tools: 22

Decision guide

How the agent turns a request into the right action.

These routes come directly from the skill instructions. They help the model recognize intent and select a focused tool or workflow instead of improvising across the entire capability surface.

01

"schema", "tables", "columns", "structure"?

WORKFLOW 1: Schema Inspection

02

"query", "select", "find data", "show me"?

WORKFLOW 2: Safe Querying

03

"slow", "performance", "optimize", "index"?

WORKFLOW 3: Performance Analysis

04

"migrate", "alter", "add column", "create table"?

WORKFLOW 4: Migrations

05

"insert", "update", "delete", "write"?

WORKFLOW 5: Governed Writes

06

Unclear?

list_tables first to understand the database

Proven workflows

Repeatable sequences for useful outcomes.

A workflow joins several tool calls into a task the user actually recognizes. The skill explains the sequence and the intended result while ADK-Rust streams the agent's progress through the shared runtime.

012-4 calls

Schema Inspection

Understand structure before acting

022-3 calls

Safe Querying

Read-only with LIMIT and EXPLAIN

033-4 calls

Performance Analysis

Find slow queries + missing indexes

043-4 calls

Migrations

Generate → validate → apply with rollback

053 calls

Governed Writes

Validate → explain scope → execute

Tool boundary

The skill may use 22 documented tools.

This allowlist is declared by the skill. It keeps the agent focused on the actions needed for this job while mcp-database retains responsibility for authentication, validation, and the connected system.

list_tables
describe_table
get_relationships
list_indexes
get_database_stats
search_schema
query
sample_data
filter_table
explain_query
get_column_stats
execute
create_index
run_migration
list_migrations
get_slow_queries
get_connections
get_maintenance_status
get_index_usage
generate_schema
get_er_diagram
validate_sql

Working rules

What the agent should do.

  • Follow the decision guide, use the declared tool boundary, and verify the result before responding.

Operating boundaries

What the agent should avoid.

  • Review the complete SKILL.md before enabling this skill for production work.

Install and connect

Add the skill beside the capability it expects.

Install the repository where your ADK-Rust skill loader can discover it, connect mcp-database, and confirm the declared tools are available before asking the agent to use the workflow.

Install the skill
git clone https://github.com/zavora-ai/skill-database-operations.git \
  ~/.skills/skills/database-operations
ADK-Rust loading shape
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("database-operations").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

The repository's compatibility statement: Requires mcp-database server connected (Supabase, PlanetScale, Neon, or Custom API).

Official documentation

Read the complete skill package.

The repository remains authoritative for its exact instructions, examples, helper scripts, assets, MCP requirements, license, and later updates.

Source record

Repository metadata for this skill entry.

View public repository ↗
License
Apache-2.0
Allowed tools
22
References
3
Revision
565646477a6f
Updated
May 31, 2026