tsql-functions — скилл для Claude Code: что делает и как установить
Скилл tsql-functions для Claude Code — справочник функций T-SQL для SQL Server и Azure SQL Database с категориями и версиями. Включается при работе с запросами T-SQL.
MIT 187 установок ★ 66 обновлён 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a claude-codeЧто делает tsql-functions
Скилл держит под рукой каталог функций T-SQL по категориям: строковые, даты и время, математика и приведение типов, оконные и ранжирующие, JSON, XML, агрегаты с расширениями GROUP BY, системные представления и метаданные. Он включается сам, когда в разговоре всплывают STRING_AGG, DATETRUNC или OPENJSON, и отвечает готовым примером, а не отсылкой к документации.
Внутри SKILL.md — таблицы функций с колонкой версии и рабочие шаблоны: нарастающий итог через SUM() OVER, разбор строки на строки таблицы, объект JSON из обычных колонок. Две категории вынесены в отдельные файлы: references/string-functions.md и references/window-functions.md.
Пометки версий здесь важнее самих описаний. CONCAT_WS, STRING_AGG и TRIM появились в 2017, AT TIME ZONE в 2016, а DATETRUNC и GENERATE_SERIES только в 2022. Соберёте запрос с ними на инстансе 2019 — он упадёт на компиляции, потому что функции там нет.
Какие задачи решает
- собрать ФИО из трёх колонок, не оставив лишних запятых на NULL
- разложить строку вида
apple,banana,cherryна строки таблицы - посчитать нарастающий итог по каждому клиенту
- вытащить
$.customer.nameиз JSON-колонки в обычный столбец - сверить список функций в запросе с версией SQL Server
Примеры запросов агенту
- Перепиши агрегат так, чтобы сотрудники по отделам шли через запятую в порядке
HireDate - Замени
JSON_VALUEнаOPENJSONсWITH, чтобы изOrderDetailsполучилась нормальная таблица - Проверь, какие функции в этом запросе не работают на SQL Server 2019, и предложи замену
Как установить tsql-functions
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a claude-code2Вручную: положить файлы
~/.claude/skills/tsql-functions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tsql-functions/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a codex2Вручную: положить файлы
.agents/skills/tsql-functions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a cursor2Вручную: положить файлы
.cursor/skills/tsql-functions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/tsql-master/skills/tsql-functions2Вручную: положить файлы
.github/skills/tsql-functions/SKILL.md1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a gemini-cli2Командой платформы
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/tsql-master/skills/tsql-functionsВручную: положить файлы
.devin/skills/tsql-functions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tsql-functions
Как установить tsql-functions в Claude Code?
Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill tsql-functions -a claude-code. Скилл окажется в ~/.claude/skills/tsql-functions/SKILL.md.
Что делает tsql-functions?
Это справочник по функциям T-SQL для SQL Server и Azure SQL Database: каталог по категориям, шаблоны запросов и пометки, с какой версии функция доступна. Активируется сам, когда речь заходит о строках, датах, окнах, JSON или XML.
Подсказывает ли скилл, с какой версии доступна функция?
Да, у каждой строки таблицы стоит версия, а для релизов 2016, 2019 и 2022 есть отдельная матрица доступности. Это помогает не тащить в проект функцию, которой на вашем инстансе нет.
Исходный текст
SKILL.md · MIT
---
name: tsql-functions
description: |
Complete T-SQL function reference for SQL Server and Azure SQL Database.
PROACTIVELY activate for: (1) string functions (CONCAT_WS, STRING_SPLIT, STRING_AGG, TRIM, REPLACE, LEFT/RIGHT/SUBSTRING), (2) date/time functions (DATEADD, DATEDIFF, FORMAT, DATETRUNC, AT TIME ZONE), (3) math and conversion functions (CAST, CONVERT, TRY_CAST, ROUND, FLOOR, CEILING), (4) window/ranking functions (ROW_NUMBER, RANK, LEAD/LAG, FIRST_VALUE, LAST_VALUE, NTILE), (5) JSON functions (JSON_VALUE, JSON_QUERY, JSON_MODIFY, OPENJSON), (6) XML functions (FOR XML, .nodes, .value), (7) aggregate functions and GROUP BY extensions, (8) system and metadata functions (sys.* views, OBJECT_ID, OBJECT_NAME).
Provides: function catalog grouped by category, version-availability matrix (SQL 2016+/2019+/2022+), and worked examples for each function family.
---
# T-SQL Functions Reference
Complete reference for all T-SQL function categories with version-specific availability.
## Quick Reference
### String Functions
| Function | Description | Version |
|----------|-------------|---------|
| `CONCAT(str1, str2, ...)` | NULL-safe concatenation | 2012+ |
| `CONCAT_WS(sep, str1, ...)` | Concatenate with separator | 2017+ |
| `STRING_AGG(expr, sep)` | Aggregate strings | 2017+ |
| `STRING_SPLIT(str, sep)` | Split to rows | 2016+ |
| `STRING_SPLIT(str, sep, 1)` | With ordinal column | 2022+ |
| `TRIM([chars FROM] str)` | Remove leading/trailing | 2017+ |
| `TRANSLATE(str, from, to)` | Character replacement | 2017+ |
| `FORMAT(value, format)` | .NET format strings | 2012+ |
### Date/Time Functions
| Function | Description | Version |
|----------|-------------|---------|
| `DATEADD(part, n, date)` | Add interval | All |
| `DATEDIFF(part, start, end)` | Difference (int) | All |
| `DATEDIFF_BIG(part, s, e)` | Difference (bigint) | 2016+ |
| `EOMONTH(date, [offset])` | Last day of month | 2012+ |
| `DATETRUNC(part, date)` | Truncate to precision | 2022+ |
| `DATE_BUCKET(part, n, date)` | Group into buckets | 2022+ |
| `AT TIME ZONE 'tz'` | Timezone conversion | 2016+ |
### Window Functions
| Function | Description | Version |
|----------|-------------|---------|
| `ROW_NUMBER()` | Sequential unique numbers | 2005+ |
| `RANK()` | Rank with gaps for ties | 2005+ |
| `DENSE_RANK()` | Rank without gaps | 2005+ |
| `NTILE(n)` | Distribute into n groups | 2005+ |
| `LAG(col, n, default)` | Previous row value | 2012+ |
| `LEAD(col, n, default)` | Next row value | 2012+ |
| `FIRST_VALUE(col)` | First in window | 2012+ |
| `LAST_VALUE(col)` | Last in window | 2012+ |
| `IGNORE NULLS` | Skip NULLs in offset funcs | 2022+ |
### SQL Server 2022 New Functions
| Function | Description |
|----------|-------------|
| `GREATEST(v1, v2, ...)` | Maximum of values |
| `LEAST(v1, v2, ...)` | Minimum of values |
| `DATETRUNC(part, date)` | Truncate date |
| `GENERATE_SERIES(start, stop, [step])` | Number sequence |
| `JSON_OBJECT('key': val)` | Create JSON object |
| `JSON_ARRAY(v1, v2, ...)` | Create JSON array |
| `JSON_PATH_EXISTS(json, path)` | Check path exists |
| `IS [NOT] DISTINCT FROM` | NULL-safe comparison |
## Core Patterns
### String Manipulation
```sql
-- Concatenate with separator (NULL-safe)
SELECT CONCAT_WS(', ', FirstName, MiddleName, LastName) AS FullName
-- Split string to rows with ordinal
SELECT value, ordinal
FROM STRING_SPLIT('apple,banana,cherry', ',', 1)
-- Aggregate strings with ordering
SELECT DeptID,
STRING_AGG(EmployeeName, ', ') WITHIN GROUP (ORDER BY HireDate)
FROM Employees
GROUP BY DeptID
```
### Date Operations
```sql
-- Truncate to first of month
SELECT DATETRUNC(month, OrderDate) AS MonthStart
-- Group by week buckets
SELECT DATE_BUCKET(week, 1, OrderDate) AS WeekBucket,
COUNT(*) AS OrderCount
FROM Orders
GROUP BY DATE_BUCKET(week, 1, OrderDate)
-- Generate date series
SELECT CAST(value AS date) AS Date
FROM GENERATE_SERIES(
CAST('2024-01-01' AS date),
CAST('2024-12-31' AS date),
1
)
```
### Window Functions
```sql
-- Running total with partitioning
SELECT OrderID, CustomerID, Amount,
SUM(Amount) OVER (
PARTITION BY CustomerID
ORDER BY OrderDate
ROWS UNBOUNDED PRECEDING
) AS RunningTotal
FROM Orders
-- Get previous non-NULL value (SQL 2022+)
SELECT Date, Value,
LAST_VALUE(Value) IGNORE NULLS OVER (
ORDER BY Date
ROWS BETWEEN UNBOUNDED PRECEDING AND 1 PRECEDING
) AS PreviousNonNull
FROM Measurements
```
### JSON Operations
```sql
-- Extract scalar value
SELECT JSON_VALUE(JsonColumn, '$.customer.name') AS CustomerName
-- Parse JSON array to rows
SELECT j.ProductID, j.Quantity
FROM Orders
CROSS APPLY OPENJSON(OrderDetails)
WITH (
ProductID INT '$.productId',
Quantity INT '$.qty'
) AS j
-- Build JSON object (SQL 2022+)
SELECT JSON_OBJECT('id': CustomerID, 'name': CustomerName) AS CustomerJson
FROM Customers
```
## Additional References
For deeper coverage of specific function categories, see:
- `references/string-functions.md` - Complete string function reference with examples
- `references/window-functions.md` - Window and ranking functions with frame specifications
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace