К основному содержанию
скилл CX Codex

power-query-m — скилл Claude Code: что делает, установка

Скилл для Claude Code помогает писать Power Query M, разбирать query folding и собирать ETL-преобразования. Охватывает запросы, параметры и коннекторы.

MIT 114 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill power-query-m -a claude-code
Открыть на GitHub

Что делает power-query-m

Скилл помогает писать запросы на M и разбирать структуру let...in. Он покрывает фильтрацию, объединение и добавление таблиц, pivot и unpivot, смену типов, работу со списками и функциями Table.TransformColumns, List.Generate, Record.Field. Есть шаблоны для динамических источников, параметров и обработки ошибок через try/otherwise.

Отдельный блок посвящён query folding: скилл помогает проверить Native Query и понять, на каком шаге вычисления перестали передаваться источнику. Он также разбирает диагностику запросов, снижение объёма данных и стратегию разбиения. Для custom connector используется Power Query SDK. Если применить Table.Buffer, последующие шаги уже не смогут складываться в запрос источника.

Скилл устанавливается в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для установки в Claude Code нужен npx; после команды файл скилла находится в ~/.claude/skills/power-query-m/SKILL.md.

Какие задачи решает

  • написать запрос Power Query M для ETL
  • проверить, где ломается query folding
  • объединить, развернуть или повернуть таблицы
  • задать динамический источник и параметры
  • обработать ошибки в M-запросе

Примеры запросов агенту

  • Напиши запрос Power Query M, который фильтрует активные строки и меняет тип Amount на число.
  • Проверь query folding для этого запроса и укажи шаг, на котором он ломается.
  • Собери пагинацию через List.Generate и объедини результаты в таблицу.

Как установить power-query-m

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill power-query-m -a claude-code

2Вручную: положить файлы

~/.claude/skills/power-query-m/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/power-query-m/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о power-query-m

Как установить power-query-m в Claude Code?

Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill power-query-m -a claude-code, затем проверьте файл ~/.claude/skills/power-query-m/SKILL.md.

Что делает power-query-m?

Скилл помогает писать M-код для ETL и преобразований, диагностировать query folding, создавать динамические источники и обрабатывать ошибки. Он также охватывает разработку custom connector.

С какими платформами работает power-query-m?

Скилл предназначен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

Исходный текст

SKILL.md · MIT
---
name: power-query-m
description: |
  Power Query M language for ETL, transformations, and connector authoring.
  PROACTIVELY activate for: (1) writing Power Query M code, (2) query folding and Native Query verification, (3) data transformations (merge, append, pivot, unpivot, split column), (4) custom connector development, (5) Power Query parameters and dynamic source patterns, (6) performance optimization (folding, query reduction, partition strategy), (7) Table.TransformColumns, List.Generate, Record.Field functions, (8) error handling in M (try/otherwise, error records), (9) mashup engine internals, (10) ETL pipelines from folder/SharePoint/database sources.
  Provides: M language reference, query-folding diagnosis, transformation recipes, dynamic source patterns, error-handling templates, and performance tuning techniques.
---

# Power Query (M Language)

## Overview

Power Query is the data transformation engine in Power BI, using the M functional language. It handles ETL (Extract, Transform, Load) from sources to the data model. Understanding query folding, step optimization, and M syntax is critical for performant data refresh.

## Query Folding

Query folding translates M steps into native source queries (SQL, OData, etc.), pushing computation to the source instead of the mashup engine.

**How to check folding:**
1. Right-click a step in Applied Steps > "View Native Query" -- if grayed out, folding broke
2. Use Query Diagnostics (Tools > Start Diagnostics) to see what queries are sent

**Steps that fold (common):**
| Operation | SQL Translation |
|-----------|----------------|
| Remove columns | SELECT (column list) |
| Filter rows | WHERE clause |
| Sort rows | ORDER BY |
| Group by | GROUP BY |
| Rename columns | Column aliases |
| Change type (basic) | CAST |
| Merge queries (database) | JOIN |
| Top N rows | TOP / LIMIT |
| Remove duplicates | DISTINCT |

**Steps that break folding:**
| Operation | Why |
|-----------|-----|
| Add custom column (complex) | M expression cannot translate to SQL |
| Pivot/Unpivot (sometimes) | Depends on source capability |
| Merge with non-foldable source | Cannot push cross-source joins |
| Table.Buffer | Explicitly materializes in memory |
| Reorder after custom step | Once broken, subsequent steps cannot fold |
| Date/time transforms (some) | Source-specific function differences |

**Golden rule:** Put foldable steps BEFORE non-foldable steps. Once folding breaks, all subsequent steps run in the mashup engine.

## M Language Essentials

### Let Expression (Query Structure)

Every Power Query query is a `let...in` expression:

```m
let
    Source = Sql.Database("server", "database"),
    Filtered = Table.SelectRows(Source, each [Status] = "Active"),
    Renamed = Table.RenameColumns(Filtered, {{"OldName", "NewName"}}),
    Typed = Table.TransformColumnTypes(Renamed, {{"Amount", type number}})
in
    Typed
```

### Data Types

| M Type | Description |
|--------|-------------|
| `type text` | String/text |
| `type number` | Decimal number |
| `Int64.Type` | Whole number (64-bit integer) |
| `type date` | Date only |
| `type datetime` | Date and time |
| `type datetimezone` | Date, time, and timezone |
| `type duration` | Time duration |
| `type logical` | Boolean (true/false) |
| `type binary` | Binary data |
| `type null` | Null value |
| `Currency.Type` | Fixed decimal (4 places) |
| `Percentage.Type` | Percentage |

### Common Table Functions

```m
// Filter rows
Table.SelectRows(table, each [Column] > 100)

// Add column
Table.AddColumn(table, "NewCol", each [Col1] * [Col2], type number)

// Remove columns
Table.RemoveColumns(table, {"Col1", "Col2"})

// Select columns (keep only these)
Table.SelectColumns(table, {"Col1", "Col2", "Col3"})

// Rename columns
Table.RenameColumns(table, {{"Old1", "New1"}, {"Old2", "New2"}})

// Change types
Table.TransformColumnTypes(table, {{"Col1", type number}, {"Col2", type text}})

// Replace values
Table.ReplaceValue(table, "old", "new", Replacer.ReplaceText, {"Column"})

// Group by
Table.Group(table, {"GroupCol"}, {
    {"Sum", each List.Sum([Amount]), type number},
    {"Count", each Table.RowCount(_), Int64.Type}
})

// Merge (JOIN)
Table.NestedJoin(left, {"KeyCol"}, right, {"KeyCol"}, "Merged", JoinKind.LeftOuter)

// Expand merged columns
Table.ExpandTableColumn(merged, "Merged", {"Col1", "Col2"})

// Pivot
Table.Pivot(table, List.Distinct(table[PivotCol]), "PivotCol", "ValueCol")

// Unpivot
Table.UnpivotOtherColumns(table, {"KeepCol1", "KeepCol2"}, "Attribute", "Value")

// Sort
Table.Sort(table, {{"Col1", Order.Ascending}, {"Col2", Order.Descending}})

// Remove duplicates
Table.Distinct(table, {"KeyCol1", "KeyCol2"})

// Combine/Append tables
Table.Combine({table1, table2, table3})

// Buffer (force materialization)
Table.Buffer(table)
```

### List Functions

```m
// Generate a sequence
{1..100}
List.Numbers(1, 100)
List.Dates(#date(2024,1,1), 365, #duration(1,0,0,0))

// Transform
List.Transform({1,2,3}, each _ * 2)

// Filter
List.Select({1,2,3,4,5}, each _ > 3)

// Aggregate
List.Sum(list), List.Average(list), List.Min(list), List.Max(list)

// Generate with custom logic (pagination pattern)
List.Generate(
    () => [Page = 0, Data = GetPage(0)],
    each [Data] <> null,
    each [Page = [Page] + 1, Data = GetPage([Page] + 1)],
    each [Data]
)
```

## Parameters and Dynamic Sources

Create parameters for environment-specific connections:

```m
// Define parameter in Power Query UI or M:
// Name: ServerName, Type: Text, Current Value: "prod-server.database.windows.net"

// Use in query:
let
    Source = Sql.Database(ServerName, DatabaseName),
    ...
```

**Dynamic source pattern:**
```m
let
    BaseUrl = "https://api.example.com/v2/",
    Endpoint = BaseUrl & "data?page=",
    GetPage = (pageNum as number) =>
        let
            url = Endpoint & Number.ToText(pageNum),
            response = Json.Document(Web.Contents(url))
        in
            response[results],
    AllPages = List.Generate(
        () => [i = 1, res = GetPage(1)],
        each List.Count([res]) > 0,
        each [i = [i] + 1, res = GetPage([i] + 1)],
        each [res]
    ),
    Combined = List.Combine(AllPages),
    AsTable = Table.FromList(Combined, Record.FieldValues,
        type table [id = Int64.Type, name = text, value = number])
in
    AsTable
```

## Error Handling

```m
// Try/otherwise pattern
let
    result = try SomeRiskyOperation() otherwise "default"
in
    result

// Try with error record inspection
let
    attempt = try Number.FromText("abc"),
    output = if attempt[HasError]
        then "Error: " & attempt[Error][Message]
        else attempt[Value]
in
    output

// Replace errors in a column
Table.ReplaceErrorValues(table, {{"Column1", null}, {"Column2", 0}})

// Remove error rows
Table.RemoveRowsWithErrors(table, {"Column1", "Column2"})
```

## Custom Connectors

Build custom Power Query connectors using the Power Query SDK:

1. Install Power Query SDK (VS Code extension)
2. Create a `.mproj` project with `DataConnector.pq` file
3. Implement the data source function with authentication
4. Package as `.mez` file
5. Deploy to `Documents\Power BI Desktop\Custom Connectors` or gateway

**Basic connector structure:**
```m
section MyConnector;

[DataSource.Kind="MyConnector", Publish="MyConnector.Publish"]
shared MyConnector.Contents = (url as text) =>
    let
        source = Web.Contents(url),
        json = Json.Document(source)
    in
        json;

MyConnector = [
    Authentication = [
        Key = [],
        OAuth = [...]
    ],
    Label = "My Custom Connector"
];

MyConnector.Publish = [
    Beta = true,
    Category = "Other",
    ButtonText = {"My Connector", "Connect to My Service"}
];
```

## Performance Optimization

| Technique | Impact |
|-----------|--------|
| Put foldable steps first | High -- pushes work to source |
| Remove unused columns early | High -- reduces data volume |
| Filter early, before joins | High -- reduces row count |
| Avoid Table.Buffer unless needed | Medium -- prevents unnecessary materialization |
| Use native queries when folding fails | High -- bypass mashup engine |
| Disable "Include in report refresh" for staging queries | Medium -- skips unnecessary refresh |
| Use Table.Partition for parallel loading | Medium -- parallelizes large tables |
| Set Privacy Levels correctly | Medium -- incorrect levels block folding |

## Additional Resources

### Reference Files
- **`references/m-patterns-cookbook.md`** -- Common M patterns: web API pagination, incremental load, JSON flattening, CSV handling, SharePoint folder combine

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Данные и базы» →
power-query Kurt Buhler Помогает писать, отлаживать и проверять выражения Power Query M в секциях семантических моделей Power BI с сохранением query folding. CX Codex +1 ★ 1 104звёзд репо power-bi-salespulse-360-dashboard reason-machines Скилл power-bi-salespulse-360-dashboard для Claude Code помогает настраивать дашборд Power BI SalesPulse 360 для анализа продаж, прибыли и регионов. Подключается к запросам о прогнозировании продаж и настройке порогов оповещений. CX Codex +1 661установок power-bi-retail-analytics-dashboard reason-machines Скилл power-bi-retail-analytics-dashboard помогает агенту собирать и настраивать розничный дашборд в Power BI: продажи, прибыль, регионы, прогнозы и оповещения. CX Codex +1 384установок Power BI Data Modeling Expert Mode официальный github Субагент Power BI Data Modeling Expert Mode проектирует схемы «звезда», настраивает связи и оптимизирует составные модели Power BI, сверяясь с документацией через microsoft.docs.mcp. CX Codex +1 ★ 41 430звёзд репо powerbi-expert PCL Team Скилл powerbi-expert для Claude Code и других платформ: DAX, язык M, моделирование данных, Power Query и отчёты. Пишет меры и чинит модель по правилам Power BI. CX Codex +1 383установок semantic-models Kurt Buhler Плагин semantic-models для проектирования, оптимизации и ревью семантических моделей Power BI прямо в Claude Code. Помогает структурировать данные, применять соглашения об именовании и писать запросы Power Query. ★ 1 104звёзд репо

Из того же набора96

Весь набор →
skill-development Скилл skill-development для Claude Code описывает правила SKILL.md для плагинов Claude: фронтматтер, структуру каталогов и исправление скиллов, которые не срабатывают. CX Codex +1 116установок agent-development Скилл agent-development помогает настроить frontmatter и системные промпты агентов для Claude Code. Пригодится при создании агента или разборе ситуации, когда он не срабатывает. CX Codex +1 116установок ffmpeg-stabilization-360 Скилл ffmpeg-stabilization-360 для Claude Code обрабатывает тряску видео и конвертирует проекции 360/VR. Активируется для стабилизации, коррекции объектива и эффектов панорамирования и зума. CX Codex +1 115установок viral-video-long-form Скилл viral-video-long-form для Claude Code помогает планировать длинные YouTube-видео и улучшать их SEO, удержание аудитории и обложки. Активируется для стратегии канала, структуры ролика и разбора аналитики. CX Codex +1 114установок adf-ml-analytics Скилл adf-ml-analytics для Claude Code содержит рецепты batch-скоринга Azure ML, запуска Databricks и архивации SQL в Storage через Azure Data Factory. Для новых пайплайнов предлагает batch-эндпоинты SDK v2 вместо SDK v1. CX Codex +1 113установок ffmpeg-filter-complex-patterns Скилл ffmpeg-filter-complex-patterns для Claude Code объясняет синтаксис сложных фильтров FFmpeg. Он подключается к вопросам о композиции видео, переходах, аудиомикшировании и маршрутизации потоков. CX Codex +1 112установок hook-development Скилл hook-development помогает создавать и настраивать хуки Claude Code: от проверок перед вызовом инструмента до запуска тестов после изменений. Пригодится и для поиска причин, почему хук не срабатывает. CX Codex +1 112установок ffmpeg-video-analysis Скилл ffmpeg-video-analysis для Claude Code анализирует видео через фильтры FFmpeg и помогает искать дефекты и оценивать качество. Включается для проверки чёрных и замороженных кадров, размытости, склеек и кадрирования. CX Codex +1 111установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой