Write descriptions

Generate Measure Descriptions

Document

Document

write-descriptions

Overview

Features

Prompts

Help

Key Features

Open a model with a couple of hundred measures and no descriptions, and every time a colleague hovers over one in Tabular Editor they're stuck reading raw DAX to work out what it does. Writing all those summaries by hand takes days, and BPA flags every undocumented measure as a violation on top of that. This skill reads your model, fills in the obvious ones automatically (colour constants, blanks, tooltip and legend helpers, plain aggregations), groups the rest by their shared prefixes so similar measures are handled together, and writes a clear, business-friendly description straight into the TMDL for each one — then hands you a report to check before you commit anything — run it with /write-descriptions.

Tip — run on a clean model. Each measure in scope consumes context. Remove unused or deprecated measures first (use the Measure Killer Analysis or Duplicate Measures skills) so Claude spends tokens on measures that matter. The leaner the model, the better the results.

How it works

Heads up — this one is context-hungry. Claude reads and reasons over every measure that isn't auto-templated, so a large model can use a lot of context in a single run. Trim the model first (see the tip above) and run it when you're not deep into a long session, so there's plenty of room to work. The skill processes measures in batches and resumes automatically if a run is interrupted, so big models still finish.

Type /write-descriptions, point it to your PBIP project, and the skill handles everything:

  1. Scans all TMDL table files and extracts measure names, DAX expressions, format strings, and existing descriptions

  2. Auto-templates deterministic infrastructure measures (hex color constants, blank placeholders, tooltip and legend helpers, standard aggregations) without Claude generation

  3. Discovers prefix clusters — groups of measures sharing a common prefix — and processes one representative per cluster for efficient token use

  4. Generates business-friendly descriptions for all remaining measures in batches, resuming automatically from any interruption

  5. Writes /// description triple-slash comments directly before each measure declaration in the TMDL files

  6. Produces a verification report listing every measure, its DAX, and the generated description for human review

What you get

  • Updated TMDL files/// description comments inserted immediately before every measure declaration

  • Descriptions in intellisense — visible in Tabular Editor properties panel and DAX Studio autocomplete tooltip after one run

  • Auto-templated infrastructure — hex colors, blank measures, tooltip and legend helpers, standard aggregations handled without Claude API calls

  • Verification report (.md) — every measure with its name, DAX expression, and generated description, organized by table. Share this with the client or model owner before committing — it gives them a full list to review, correct, or approve without opening Tabular Editor.

All report files follow consistent naming: {project}_measure_descriptions_{date}_{time}.md

Tool Information

Skill

39 USD

Bundle (All skills)

249 USD

Category

Document

Version

Version 2.1.1.2.15

or log in if you already have an account