Skip to content
TakoAPI
Back to skills

db-readonly

by reed1898

Browser & Automation
835Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Run safe read-only queries against MySQL or PostgreSQL for data inspection, reporting, and troubleshooting.

Description

What This Skill Does

Runs read-only queries against PostgreSQL or MySQL databases. Supports SELECT, WITH, and EXPLAIN statements, and can export results to CSV, TSV, or JSON. Blocks INSERT, UPDATE, DELETE, DROP, and ALTER to prevent accidental data modification.

Enforces read-only access at the skill level, so exploratory database work can't accidentally modify or delete data.

When to Use It

  • Inspecting table schemas before writing a migration
  • Counting rows to verify a data import completed
  • Sampling user records to debug a reported issue
  • Exporting query results to CSV for a stakeholder report
  • Running EXPLAIN on a slow query to diagnose performance

Example Workflow

INPUT

User asks: Show me the 10 most recent orders with their totals

AGENT
  1. 1

    Reads PGHOST, PGDATABASE, PGUSER, PGPASSWORD from environment

  2. 2

    Constructs a SELECT query with ORDER BY created_at DESC and LIMIT 10

  3. 3

    Runs scripts/db_readonly.sh postgres with the query

  4. 4

    Returns the result rows to the user

OUTPUT

A table of 10 order rows showing id, created_at, and total columns

Requirements

  • PostgreSQL connection environment variables: PGHOST, PGDATABASE, PGUSER, PGPASSWORD
  • MySQL connection environment variables: MYSQL_HOST, MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD

Installation

clawhub install reed1898/db-readonly

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links