minasaad1/pbi-cli/power-bi-docs

Claude Code and agent skill by minasaad1/pbi-cli

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Auto-document Power BI semantic models by extracting metadata, generating documentation, and cataloging all model objects using pbi-cli. Invoke this skill whenever the user says "document this model", "what's in this model", "list everything", "data dictionary", "model inventory", "audit contents", "catalog", "describe the model", or wants to understand what objects exist in a semantic model.

Install

npx vskill@latest install minasaad1/pbi-cli/power-bi-docs

SKILL.md

Power BI Documentation Skill

Generate comprehensive documentation for Power BI semantic models.

Prerequisites

bash
pipx install pbi-cli-tool
pbi-cli skills install
pbi connect

Quick Model Overview

bash
pbi --json model get       # Model metadata
pbi --json model stats     # Table/measure/column counts

Catalog All Objects

bash
# Tables and their structure
pbi --json table list
pbi --json table get Sales
pbi --json table schema Sales
 
# All measures
pbi --json measure list
 
# Individual measure details
pbi --json measure get "Total Revenue" --table Sales
 
# Columns per table
pbi --json column list --table Sales
pbi --json column list --table Products
 
# Relationships
pbi --json relationship list
 
# Security roles
pbi --json security-role list
 
# Hierarchies
pbi --json hierarchy list --table Date
 
# Calculation groups
pbi --json calc-group list
 
# Perspectives
pbi --json perspective list
 
# Named expressions (M queries)
pbi --json expression list
 
# Partitions
pbi --json partition list --table Sales
 
# Calendar/date tables
pbi --json calendar list

Export Full Model as TMDL

bash
pbi database export-tmdl ./model-docs/

This creates a human-readable text representation of the entire model.

Workflow: Generate Model Documentation

Run these commands to gather all information needed for documentation:

bash
# Step 1: Model overview
pbi --json model get > model-meta.json
pbi --json model stats > model-stats.json
 
# Step 2: All tables
pbi --json table list > tables.json
 
# Step 3: All measures
pbi --json measure list > measures.json
 
# Step 4: All relationships
pbi --json relationship list > relationships.json
 
# Step 5: Security roles
pbi --json security-role list > security-roles.json
 
# Step 6: Column details per table (loop through tables)
pbi --json column list --table Sales > columns-sales.json
pbi --json column list --table Products > columns-products.json
 
# Step 7: Full TMDL export
pbi database export-tmdl ./tmdl-export/

Then assemble these JSON files into markdown or HTML documentation.

Workflow: Data Dictionary

For each table, extract columns and their types:

bash
# Get schema for key tables
pbi --json table schema Sales
pbi --json table schema Products
pbi --json table schema Calendar

Workflow: Measure Catalog

Create a complete measure inventory:

bash
# List all measures with expressions
pbi --json measure list
 
# Export full model as TMDL (includes all measure definitions)
pbi database export-tmdl ./tmdl-export/

Culture Management

For multi-language models:

bash
# List cultures (locales)
pbi --json advanced culture list
 
# Create a culture for localization
pbi advanced culture create "fr-FR"
 
# Delete a culture
pbi advanced culture delete "fr-FR"

Best Practices

  • Always use --json flag for machine-readable output
  • Export TMDL alongside JSON for complete documentation
  • Run documentation generation as part of CI/CD pipeline
  • Keep documentation in version control alongside TMDL exports
  • Include relationship diagrams (generate from pbi --json relationship list)
  • Document measure business logic, not just DAX expressions
  • Tag measures by business domain using display folders

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
400
Repository forks
107
7-day trend score
30

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/minasaad1/pbi-cli/power-bi-docs/badge)](https://verified-skill.com/skills/minasaad1/pbi-cli/power-bi-docs)

Something wrong with this skill or its page? Tell us.