Home / vanterx / mssql-performance-skills · skills/sqlplan-review/SKILL.md · GitHub

sqlplan-review skillA

sqlplan-review is agent-read markdown (skill) from vanterx/mssql-performance-skills: Analyze SQL Server execution plans for performance anti-patterns, bottleneck identification, and actionable fix recommendations. Applies 111 checks (S1–S38 statement-level, N1–N73 node-level) covering memory grants, parallelism, cardinality errors, spills, scans, index usage, IQP/PSP features, ADR, CE feedback, hidden UDF cost, and in-plan wait stats. Use this skill whenever a user pastes a .sqlplan file or XML, shares an SSMS execution plan, asks why a query is slow or regressed after a deploym.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# SQL Server Execution Plan Review Skill

## Purpose

Analyze a SQL Server execution plan for performance anti-patterns and produce a prioritized, actionable report. Based on the same analysis ruleset used by commercial SQL Server execution plan tools. Covers 111 checks across statement-level (S1–S38) and node-level (N1–N73) categories.

## Input

Accept any of:
- Raw `.sqlplan` XML (paste or file contents)
- A description of the plan tree (operator names, row counts, costs)
- A question like "why is this query slow?" with plan details included

If the user provides XML, extract the relevant attributes yourself before running checks. If the input is a description, apply the checks based on what is mentioned.

SSMS saves `.sqlplan` files as UTF-16 encoded XML. A byte-oriented text search (`grep`, `findstr`) over the raw file silently returns no matches on UTF-16 content even though the file is not empty — parse the file as XML, or read its full contents, rather than line-searching it.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add vanterx/mssql-performance-skills/sqlplan-review@git:20260919.8a7bf7e
Exact content
mdr add vanterx/mssql-performance-skills/sqlplan-review@sha256:948f8a09d314068c

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.8a7bf7e latest2026-09-19 8a7bf7e 82,250 BA view · diff
git:20260712.b4946132026-07-12 b494613 82,051 BA view · diff
git:20260618.5cdc14a2026-06-18 5cdc14a 73,047 BA view · diff
git:20260618.c07d2172026-06-18 c07d217 73,135 BA view · diff
git:20260610.9eda42c2026-06-10 9eda42c 73,024 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (82250 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

vanterx/mssql-performance-skills · 5 stars · license MIT · pushed 2026-09-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_m3h2kuqgkdezila7
GET https://markdownregistry.com/api/v1/resolve?ref=vanterx/mssql-performance-skills/sqlplan-review
GET https://markdownregistry.com/api/v1/blob/948f8a09d314068cb054d4cc9947652d7cdcb9fa5e89837b21210a9b12e96662

Your agent 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.

More from vanterx/mssql-performance-skills

AGENTS.md agents
vanterx/mssql-performance-skills · AGENTS.md
git:20260709.012214c · audit A · 5 stars
CLAUDE.md claude
vanterx/mssql-performance-skills · CLAUDE.md
git:20260919.8a7bf7e · audit A · 5 stars
mssql-performance-review skill
vanterx/mssql-performance-skills · skills/mssql-performance-review/SKILL.md · Agentic offline orchestrator for end-to-end SQL Server performance reviews. Forms hypotheses from artifacts or…
git:20260919.8a7bf7e · audit A · 5 stars
sqlag-review skill
vanterx/mssql-performance-skills · skills/sqlag-review/SKILL.md · Audits SQL Server Always On Availability Group configuration correctness across all layers — prerequisites, replica…
git:20260622.55f8c85 · audit A · 5 stars
sqlblocking-review skill
vanterx/mssql-performance-skills · skills/sqlblocking-review/SKILL.md · Analyze SQL Server lock blocking from sys.dm_exec_requests, sys.dm_exec_sessions, sys.dm_os_waiting_tasks…
git:20260919.8a7bf7e · audit A · 5 stars
sqlbootstraplog-review skill
vanterx/mssql-performance-skills · skills/sqlbootstraplog-review/SKILL.md · Analyze SQL Server Setup Bootstrap log files to diagnose failed installations, failed Cumulative Update or Service Pack…
git:20260611.bd7f3cf · audit A · 5 stars
sqlclusterlog-review skill
vanterx/mssql-performance-skills · skills/sqlclusterlog-review/SKILL.md · Analyzes Windows Server Failover Cluster (WSFC) CLUSTER.LOG files for Always On Availability Group root-cause…
git:20260622.55f8c85 · audit A · 5 stars
sqldbconfig-review skill
vanterx/mssql-performance-skills · skills/sqldbconfig-review/SKILL.md · Analyze SQL Server instance and database configuration drift against proven DBA best practices. Applies 29 checks…
git:20260919.8a7bf7e · audit A · 5 stars
sqldeadlock-review skill
vanterx/mssql-performance-skills · skills/sqldeadlock-review/SKILL.md · Analyze SQL Server deadlock XML (from system_health XE session, SSMS deadlock graph, or trace) to identify root cause…
git:20260919.8a7bf7e · audit A · 5 stars
sqldiskio-review skill
vanterx/mssql-performance-skills · skills/sqldiskio-review/SKILL.md · Analyze SQL Server file-level I/O latency and auto-growth events using sys.dm_io_virtual_file_stats, sys.master_files…
git:20260622.55f8c85 · audit A · 5 stars
sqlencryption-review skill
vanterx/mssql-performance-skills · skills/sqlencryption-review/SKILL.md · Analyze SQL Server encryption posture across all layers — TDE, Always Encrypted, cell-level encryption, backup…
git:20260622.55f8c85 · audit A · 5 stars
sqlerrorlog-review skill
vanterx/mssql-performance-skills · skills/sqlerrorlog-review/SKILL.md · Analyzes SQL Server ERRORLOG files for operational issues, availability group failures, memory pressure, I/O subsystem…
git:20260622.55f8c85 · audit A · 5 stars

Every file in vanterx/mssql-performance-skills

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