powerbi-custom-visuals

Scaffold, build, package, and certify Power BI custom visuals with the pbiviz toolchain.

887|131|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/data-goblin/power-bi-agentic-development --skill powerbi-custom-visuals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: powerbi-custom-visuals
Source: https://github.com/data-goblin/power-bi-agentic-development/tree/main/plugins/custom-visuals/skills/powerbi-custom-visuals
Command: npx skills add https://github.com/data-goblin/power-bi-agentic-development --skill powerbi-custom-visuals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires powerbi-visuals-tools, powerbi-visuals-api, powerbi-visuals-utils-formattingmodel, eslint-plugin-powerbi-visuals, and includes references (resource) components.

What problem does it solve?

Building a distributable Power BI developer visual requires coordinating the pbiviz CLI, the powerbi-visuals-api, capabilities.json declarations, and the formatting model, and mistakes in any of these block packaging or certification. This Skill guides the full loop from scaffolding to AppSource publishing with grounded API references.

Core Features & Use Cases

  • Full development loop: Scaffold a project with pbiviz new, implement the IVisual class in TypeScript, declare data roles and objects in capabilities.json, and live-preview with pbiviz start.
  • Bundled pbiviz MCP server: Query current API docs, best practices, feature implementation steps, vulnerability scans, and certification checks while coding.
  • Certification and publishing: Audit unsafe calls with pbiviz package --certification-audit, meet AppSource requirements, and submit through Partner Center.
  • Use Case: A developer needs a reusable interactive gantt-style visual with a custom formatting pane for distribution across reports. The Skill walks them through scaffolding, dataView mapping, the formatting model, packaging the .pbiviz, and preparing certification.

Quick Start

Ask the agent to scaffold a new Power BI custom visual named MyVisual and implement its IVisual update method with a formatting card.

Frequently Asked Questions about powerbi-custom-visuals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Power BI custom visual with pbiviz?

Run pbiviz new <VisualName> to scaffold the project, implement the IVisual class in src/visual.ts, declare data roles and objects in capabilities.json, then use pbiviz start for live preview and pbiviz package to build the .pbiviz file.

What is the difference between a pbiviz custom visual and Deneb or script visuals?

A pbiviz visual is a packaged TypeScript developer visual with full interactivity, its own formatting pane, and AppSource distribution. Deneb, Python, R, and SVG approaches are lighter options for one-off charts inside a single report without packaging.

What are the requirements for Power BI visual certification?

Certification requires a lowercase certification branch matching the package, passing eslint-plugin-powerbi-visuals, no eval, fetch, or XMLHttpRequest calls, a clean npm audit, and the latest powerbi-visuals-api. R-based visuals cannot be certified.

Does the pbiviz toolchain require a specific Node.js version?

Yes, powerbi-visuals-tools requires Node.js 20.19 or later. The pbiviz CLI can be run via npx -y powerbi-visuals-tools or installed globally, and live preview needs developer mode enabled in Power BI Desktop or the service.

How do I add a formatting pane to a Power BI custom visual?

Declare objects in capabilities.json, then build the formatting model with powerbi-visuals-utils-formattingmodel. Each card name matches an object name and each slice name matches a property, returned from getFormattingModel.