Agent skill

SQL Best Practices

by aiming-lab in aiming-lab/MetaClaw

A skill your agent uses when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications.

MITAuto-check passedDatabases

Install SQL Best Practices

skills CLI
$ npx skills add aiming-lab/MetaClaw --skill sql-best-practices -a claude-code

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

GitHub CLI
$ gh skill install aiming-lab/MetaClaw sql-best-practices --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/aiming-lab/MetaClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/memory_data/skills/sql-best-practices .claude/skills/sql-best-practices && 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
sql-best-practices
GitHub stars
3.5k
Token cost
~234 tokens
SKILL.md length
84 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications.

  • Writing SQL queries — selects
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Window functions
  • Schema modifications

What it does

SQL Best Practices is an agent skill from aiming-lab/MetaClaw. Use this skill when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications. Apply whenever SQL is needed to ensure correctness, safety, and performance.

Its SKILL.md is about 230 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases, covering SQL. It works with SQL. The repository describes itself as: 🦞 Just talk to your agent — it learns and EVOLVES 🧬. The licence is MIT.

When your agent uses it

  • Writing SQL queries — selects
  • Window functions
  • Schema modifications

Example prompts

  • “/sql-best-practices”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

SQL Best Practices loads about 234 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 84 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from aiming-lab/MetaClaw at commit 922caf3, republished under its MIT licence (© aiming-lab). 84 words, ~234 tokens.

Download SKILL.mdSave it as .claude/skills/sql-best-practices/SKILL.md (or your agent's skills folder).
name
sql-best-practices
description
Use this skill when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications. Apply whenever SQL is needed to ensure correctness, safety, and performance.
category
data_analysis

SQL Best Practices

Query quality:

  • Use SELECT col1, col2 — never SELECT * in production code.
  • Use CTEs (WITH) for readability instead of deeply nested subqueries.
  • Filter early: apply WHERE before JOIN when possible to reduce data scanned.
  • Use EXPLAIN / EXPLAIN ANALYZE to inspect query plans for slow queries.

Safety:

  • Always use parameterized queries from application code — never string interpolation.
  • Wrap destructive operations (DELETE, UPDATE, DROP) in a transaction.
  • Test on a staging/dev environment before running on production.

Naming: snake_case for tables/columns, descriptive names, consistent pluralization.

© aiming-lab, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in memory_data/skills/sql-best-practices of aiming-lab/MetaClaw.

Open the folder on GitHubat commit 922caf3

Compare with similar skills

SQL Best Practices 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.

SQL Best Practices compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SQL Best Practices this skillaiming-lab/MetaClaw3.5k—~234Automated safety check: PassMIT
Evolving The Data ModelTriliumNext/Trilium38k—~2.1kAutomated safety check: PassAGPL-3.0
SQL Optimization Patternsynulihao/AgentSkillOS61710 repos~3.3kAutomated safety check: PassNone
SQL PortabilityHL7/sql-on-fhir150—~512Automated safety check: PassCustom licence
DB Migrationskurealnum/dotfiles290—~820Automated safety check: PassNone
Contact FilterChatbotXIO/ChatbotX878—~2.5kAutomated safety check: PassCustom licence

Similar skills

  • Evolving The Data Model

    TriliumNext/Trilium

    A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…

    38k GitHub stars~2.1k tokensUpdated today
    DatabasesAuto-check passed
  • SQL Optimization Patterns

    ynulihao/AgentSkillOS

    Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries.

    617 GitHub starsUsed in 10 repos~3.3k tokens
    DatabasesAuto-check passed
  • SQL Portability

    HL7/sql-on-fhir

    Analyse whether a SQL query is portable across database implementations using sqlglot transpilation.

    150 GitHub stars~512 tokensUpdated yesterday
    DatabasesAuto-check passed
  • DB Migrations

    kurealnum/dotfiles

    A skill your agent uses when generating or regenerating Drizzle migration files, changing database schema tables or columns, resolving migration sequence conflicts after rebase, reviewing migration…

    290 GitHub stars~820 tokensUpdated 5 mo ago
    DatabasesAuto-check passed
  • Contact Filter

    ChatbotXIO/ChatbotX

    Work with the ChatbotX contact filter system — the shared filter model behind the contacts list, conversations, and broadcast audiences.

    878 GitHub stars~2.5k tokensUpdated today
    DatabasesAuto-check passed
  • Add Utils Function

    MichealWayne/fe-tools

    Add or modify utility functions in fe-tools. An agent skill from MichealWayne/fe-tools.

    207 GitHub stars~602 tokensUpdated 29 days ago
    DatabasesAuto-check passed

More from aiming-lab/MetaClaw

All 36 skills in this repo
  • Data Validation First

    aiming-lab/MetaClaw

    Use this skill before any data analysis, transformation, or modeling.

    3.5k GitHub stars~230 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when implementing any endpoint, form handler, CLI tool, or function that accepts external input.

    3.5k GitHub stars~251 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when writing shell scripts, Python automation, or any unattended batch job.

    3.5k GitHub stars~225 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when building production services, pipelines, or automation that needs to be debugged, monitored, or audited.

    3.5k GitHub stars~247 tokensUpdated 4 mo ago
    Auto-check passed
  • Agent Task Handoff

    aiming-lab/MetaClaw

    A skill your agent uses when delegating a subtask to a sub-agent, spawning a parallel worker, or handing off work across sessions.

    3.5k GitHub stars~258 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when writing messages in async channels (Slack, GitHub issues, email threads) where the reader may not have context and cannot ask follow-up questions immediately.

    3.5k GitHub stars~224 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about SQL Best Practices

What does SQL Best Practices do?

A skill your agent uses when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications. SQL Best Practices is an agent skill from aiming-lab/MetaClaw. Use this skill when writing SQL queries — selects, joins, aggregations, window functions, or schema modifications.

When should I use SQL Best Practices?

SQL Best Practices fits situations like: writing SQL queries — selects; window functions; schema modifications.

How do I install SQL Best Practices in Claude Code?

Run `npx skills add aiming-lab/MetaClaw --skill sql-best-practices -a claude-code`. Or copy the skill folder (memory_data/skills/sql-best-practices in aiming-lab/MetaClaw) into .claude/skills/sql-best-practices in your project. Claude Code loads it when a task matches its description.

How do I install SQL Best Practices in Codex?

Run `npx skills add aiming-lab/MetaClaw --skill sql-best-practices -a codex`. Or copy the skill folder (memory_data/skills/sql-best-practices in aiming-lab/MetaClaw) into .agents/skills/sql-best-practices in your project. Codex loads it when a task matches its description.

Can I use SQL Best Practices 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 aiming-lab/MetaClaw --skill sql-best-practices -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sql-best-practices, .gemini/skills/sql-best-practices, .github/skills/sql-best-practices and .opencode/skills/sql-best-practices in your project.

What does SQL Best Practices need to run?

SKILL.md names no scripts, command-line tools or credentials: SQL Best Practices is instructions for the agent only.

Does SQL Best Practices access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SQL Best Practices safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SQL Best Practices use?

SQL Best Practices is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SQL Best Practices use?

About 234 tokens (SKILL.md is roughly 936 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 SQL Best Practices?

Skills that share tags, products or a category with SQL Best Practices: Evolving The Data Model (TriliumNext/Trilium, 38k stars), SQL Optimization Patterns (ynulihao/AgentSkillOS, 617 stars), SQL Portability (HL7/sql-on-fhir, 150 stars) and DB Migrations (kurealnum/dotfiles, 290 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SQL Best Practices?

aiming-lab (a GitHub organization) maintains it in aiming-lab/MetaClaw, which has 3,459 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on June 7, 2026.

Source: aiming-lab/MetaClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.