pbir-visuals

pbir-visuals

A Claude Code plugin for creating and managing Power BI Enhanced Report Format (PBIR) visuals using templates.

Features

• Visual Creator Skill - Create PBIR visuals from validated templates
• Template Extractor Skill - Extract existing visuals into reusable templates
• 18+ Visual Templates - Cards, charts, tables, matrices, slicers, maps

Installation

/plugin install https://github.com/cn-dataworks/pbir-visuals.git

Skills

pbir-visual-creator

Creates PBIR visuals from templates. Claude will automatically invoke this skill when you:

• Ask to add a visual to a report page
• Request a card, chart, table, or slicer
• Need to generate visual.json files

Example prompts:

• "Add a Total Sales card to the Dashboard page"
• "Create a bar chart showing revenue by region"
• "Add a date slicer for the Order Date column"

pbir-template-extractor

Extracts existing visuals into reusable templates. Claude will invoke this skill when you:

• Want to save a visual configuration as a template
• Need to standardize a visual format
• Ask to add a visual to the template library

Example prompts:

• "Extract this chart as a template"
• "Save the Revenue Trend visual as a reusable template"
• "Add this matrix format to the template library"

Available Templates

Template	Visual Type	Description
card-single-measure.json	Card	Single KPI display
line-chart-category-y.json	Line Chart	Trend over category
line-chart-multi-y.json	Line Chart	Multiple Y measures
line-chart-with-series.json	Line Chart	With legend series
bar-chart-category-y.json	Bar Chart	Horizontal bars
bar-chart-with-series.json	Bar Chart	Grouped/stacked
clustered-column-multi-measure.json	Column	Multi-measure columns
table-basic.json	Table	Columnar data
matrix-basic.json	Matrix	Pivot table
pie-chart.json	Pie Chart	Part-to-whole
scatter-bubble-chart.json	Scatter	X-Y relationship
azure-map-gradient.json	Azure Map	Filled regions
azure-map-bubble.json	Azure Map	Bubble markers
slicer-between-date.json	Slicer	Date range
slicer-dropdown.json	Slicer	Dropdown
slicer-list-multiselect.json	Slicer	Multi-select
image-static.json	Image	Static image

Using with Other Plugins

This plugin works alongside other Power BI plugins. Install multiple plugins:

/plugin install https://github.com/cn-dataworks/pbir-visuals.git
/plugin install https://github.com/cn-dataworks/powerbi-analyst-plugin.git

Both plugins operate concurrently:

• pbir-visuals handles visual creation and template management
• powerbi-analyst handles DAX, M code, and deployment workflows

Claude will invoke the appropriate skills from either plugin based on your task.

Template Format

Templates use {{PLACEHOLDER}} syntax for values:

{
  "$schema": "https://developer.microsoft.com/.../2.4.0/schema.json",
  "name": "{{VISUAL_NAME}}",
  "position": {
    "x": "{{X}}",
    "y": "{{Y}}",
    "width": "{{WIDTH}}",
    "height": "{{HEIGHT}}"
  },
  "visual": {
    "visualType": "card",
    "query": {
      "queryState": {
        "Values": {
          "projections": [{
            "field": {
              "Measure": {
                "Expression": { "SourceRef": { "Entity": "{{TABLE_NAME}}" } },
                "Property": "{{MEASURE_NAME}}"
              }
            }
          }]
        }
      }
    }
  }
}

Schema Version

All templates use PBIR schema version 2.4.0.

Contributing

We welcome community contributions! See CONTRIBUTING.md for:

• How to extract and submit new templates
• Template naming conventions
• Placeholder reference
• List of templates we need

Quick version:

1. Create a visual in Power BI Desktop (PBIR format)
2. Use the pbir-template-extractor skill to extract it
3. Submit a Pull Request

License

MIT