pbi-report-design

Applies design identity, layout, color, and accessibility rules to Power BI report pages.

6|3|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbi-report-design-insightfulanalytics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pbi-report-design
Source: https://github.com/InsightfulAnalytics/PBI_Agentic_Dev/tree/main/plugins/reports/skills/pbi-report-design
Command: npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbi-report-design-insightfulanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Power BI reports built without design discipline end up with misaligned visuals, inconsistent spacing, bare KPI numbers without targets, and poor chart choices. This Skill provides a complete design canon so AI agents produce reports that follow data visualization best practices instead of generic defaults. ## Core Features & Use Cases - Design Identity Locking: Commit a tone (restrained, corporate, editorial, technical) and a signature element before layout so every page and visual cites one propagating identity serialized into the theme. - Layout and Spacing Rules: Enforce the 3-30-300 detail gradient, equal gaps and margins computed arithmetically, grid-based positioning, and page-shape routing (summary, monitoring, exploration, comparison, narrative). - Visual-Specific Guidance: Detailed rules for KPI cards with targets and gaps, chart selection via the Cleveland-McGill encoding hierarchy, tables and matrices, slicers, filter panes, and mobile layouts. - Use Case: When building or reviewing a Power BI report, load this Skill to decide chart types, position visuals on a 1280x720 canvas with equal 16px gaps, add KPI targets, and run the closing design gate before shipping. ## Quick Start Use the pbi-report-design skill to review my report pages and fix any spacing, chart selection, or KPI design issues.

Frequently Asked Questions about pbi-report-design

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

FAQPage Schema
How do I design a Power BI report page layout?▼

Follow the 3-30-300 rule: place KPIs and cards top-left, charts in the middle, and detail tables bottom-right. Use 24-32px margins, equal 16px gaps between visuals computed arithmetically, and check the actual page dimensions in page.json before positioning anything.

How many KPI cards should a Power BI dashboard have?▼

Limit pages to 4-6 KPI cards maximum, since working memory holds roughly 3-4 chunks. Every KPI needs a target and gap in absolute and percentage terms; apply the 20% change test to keep only actionable metrics.

What chart type should I use in Power BI for comparisons?▼

Use bar or column charts for magnitude ranking, line charts for trends over time, and scatter charts for correlations. Avoid pies beyond four slices, dual y-axes, gauges, and 3D charts; sort categorical bars by value descending.

Should I use theme colors or hex codes in Power BI visuals?▼

Use theme colors via ThemeDataColor references instead of inline hex values. Theme colors propagate the design identity and re-theme cleanly, while inline hex pins a color to one visual and breaks on re-theme.

Does Power BI automatically create a mobile layout?▼

No. Power BI does not reflow desktop pages for phones; each visual needs an explicit mobile.json placement to appear in portrait view. Pages without any mobile placements fall back to rotated landscape, so curate 4-8 key visuals per page.

Why does my Power BI report look misaligned?▼

Misalignment comes from unequal gaps between visuals or positions off the grid unit. Calculate positions arithmetically from margin, gap, and page dimensions, and ensure vertical gutters align continuously across rows.