data-sql-optimization SKILL.md skillA

data-sql-optimization from vasilyu1983/ai-agents-public is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vasilyu1983/ai-agents-public/data-sql-optimization@v1.3

Pins v1.3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
vasilyu1983/ai-agents-public
Path
skills/universal/data-sql-optimization/SKILL.md
Versions recorded
1
Latest version
v1.3, committed Oct 5, 2026
Size
17,435 bytes
Repository stars
101
License
MIT

Diagnoses and tunes SQL for OLTP workloads on PostgreSQL, MySQL, and SQL Server. Use when tuning queries, reading plans, indexing, or fixing lock contention.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# SQL Optimization

**Out of scope:** OLAP engines and lakehouse tuning. Use [data-lake-platform](../data-lake-platform/SKILL.md) for ClickHouse, DuckDB, Doris, StarRocks, Iceberg, Delta Lake, or Hudi.

## Quick Reference

### Scripts

| Script | What it does | Usage |
|--------|-------------|-------|
| [scripts/pg_slow_query_triage.sql](scripts/pg_slow_query_triage.sql) | Six-section triage report from `pg_stat_statements`: total time, mean time, I/O, variance, cache-hit ratio, and spills/planning/WAL | Copy-paste into `psql` or any SQL client; requires `pg_stat_statements` extension |
| [scripts/explain_collector.py](scripts/explain_collector.py) | Collects estimated JSON plans via `psql`; `--analyze` opts into query execution | `DATABASE_URL=postgresql://... python explain_collector.py --queries slow.txt` |
| [scripts/test_explain_collector.py](scripts/test_explain_collector.py) | Offline input, execution-mode and JSON-envelope regressions | `python scripts/test_explain_collector.py` |

```bash
# Triage: paste directly into psql
psql "$DATABASE_URL" -f skills/universal/data-sql-optimization/scripts/pg_slow_query_triage.sql
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vasilyu1983/ai-agents-public/data-sql-optimization@sha256:78792caffc3255e7

The line at the top of this page pins the label v1.3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i5uerlt6veaz25ts.svg)](https://markdownregistry.com/a/art_i5uerlt6veaz25ts)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 5, 2026.

versioncommittedcommitsizeaudit
v1.3 latest2026-10-05 5db538c 17,435 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (17435 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vasilyu1983/ai-agents-public · 101 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i5uerlt6veaz25ts
GET https://markdownregistry.com/api/v1/resolve?ref=vasilyu1983/ai-agents-public/data-sql-optimization
GET https://markdownregistry.com/api/v1/blob/78792caffc3255e77878de61995e4cf064c238924234855fee031dcfc585e96c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from vasilyu1983/ai-agents-public

AGENTS.md AGENTS.md file
vasilyu1983/ai-agents-public · AGENTS.md
git:20261005.5db538c · audit A · 101 stars
AGENTS.md@agents AGENTS.md file
vasilyu1983/ai-agents-public · agents/AGENTS.md
git:20261005.5db538c · audit A · 101 stars
AGENTS.md@hooks AGENTS.md file
vasilyu1983/ai-agents-public · hooks/AGENTS.md
git:20261005.5db538c · audit A · 101 stars
agents-hooks SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-hooks/SKILL.md · Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks…
v1.6 · audit A · 101 stars
agents-mcp SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-mcp/SKILL.md · Configures and hardens Claude Code and Codex MCP servers. Use when connecting databases, APIs, SaaS, building servers…
v1.7 · audit A · 101 stars
agents-memory SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-memory/SKILL.md · Owns instruction files: AGENTS.md, CLAUDE.md, personal and repo rules. Use when writing, pruning, auditing them…
v1.6 · audit A · 101 stars
agents-skills-feedback-loop SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-skills-feedback-loop/SKILL.md · Adds per-skill learnings loops for dated patterns, mistakes, and domain facts. Use when wiring skill memory…
v1.6 · audit A · 101 stars
agents-skills SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-skills/SKILL.md · Creates and audits agent skills: SKILL.md, references, scripts, runtime metadata. Use when writing, validating, or…
v1.2 · audit A · 101 stars
agents-subagents SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-subagents/SKILL.md · Chooses subagent, team, workflow, or debate and launches it on Claude Code or Codex. Use when delegating, running agent…
v1.6 · audit A · 101 stars
agents-swarm-orchestration SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-swarm-orchestration/SKILL.md · Designs and runs agent hives and multi-agent waves. Use when setting hive roles, code gates, dependency-graph fan-out…
v1.9 · audit A · 101 stars
ai-agents SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/ai-agents/SKILL.md · AI agent architecture, graph and loop composition, protocol choice, evaluation, and observability. Use when scoping or…
v1.3 · audit A · 101 stars
ai-architecture-advisor SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/ai-architecture-advisor/SKILL.md · Chooses among AI/ML approaches: classical ML, LLM, RAG, fine-tuning, agents, embeddings, MoE or SSM. Use when picking…
v1.7 · audit A · 101 stars

Every file in vasilyu1983/ai-agents-public

Other files named data-sql-optimization

data-sql-optimization SKILL.md skill
joaoguirunas/team-os · .claude/skills/data-sql-optimization/SKILL.md · Otimização de SQL para sistemas OLTP — análise de EXPLAIN, indexação, schema design, migrations, alta disponibilidade…
v1.0 · audit A · 5 stars

Browse by kind, by grade A, or by owner.