Agent skill · Code Review & Quality

pbi-report-design

The Power BI report design canon covering design identity, visual hierarchy and the 3-30-300 rule, layout/spacing/alignment, color discipline, chart selection, KPI and card design, tables and matrices, accessibility, and the closing design gate. The shared reference home for report design judgment, routed to by the create-pbi-report, pbir-cli, review-report, modifying-theme-json, and custom-visual skills. Load when committing a design identity or making a design, layout, color, chart-selection, or accessibility decision for a report.

data-goblingithub.com/data-goblinGitHub ↗
claude-codecopilotGPL-3.0
Install
npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 15
SKILL.md size: 21 KB
Bundled scripts: none
Path: plugins/reports/skills/pbi-report-design/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 833
Language: C#

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Power BI Report Design > **Use `pbir` for every report mutation.** The `pbir-format` skill is read-only schema context. > If the CLI is unavailable or lacks an operation, stop and report the gap. Best practices and guidelines for Power BI report design. Follow these guidelines strictly to avoid generic, poorly formatted reports ("Power BI Slop"). Be innovative, pushing boundaries while adhering to data visualization rules and guidelines. Work within Power BI's constraints, aiming for simplicity and effectiveness over aesthetics and decoration. Focus reports, pages, and visuals on answering specific questions and minimizing cognitive load -- not on looking "pretty and impressive". When a user request contradicts these guidelines, push back and explain better alternatives. The goal is to inform the user of options that lead to improved outcomes. ## Design identity (commit before layout) Before any layout work, lock the report's identity so every later choice has something to cite: 1. **Pick one tone** ... a committed ink budget (`restrained`, `corporate`, `editorial`, or `technical`) that fixes accent count, saturation, gridline weight, and how forward annotation gets 2. **Pick one

What's inside
Steps it walks through
  1. Design identity (commit before layout)
  2. Core rules
  3. Page Layout Guidelines
  4. Check Page Size Before Modifying
  5. Standard Page Size
  6. Visual Spacing
  7. Detail Gradient
  8. Visual Count Guidelines
  9. Page Titles
  10. Theme Guidelines
  11. Always Check Theme First
  12. When to Modify Theme vs Visual
  13. Theme Color Usage
  14. Accessibility (WCAG 2.1)
Ships with 14 files
  • references/anti-patterns.md
  • references/cards-and-kpis.md
  • references/chart-selection.md
  • references/custom-visuals.md
  • references/design-identity.md
  • references/filter-pane.md
  • references/layout-guidelines.md
  • references/mobile.md
  • references/page-shapes.md
  • references/page-titles.md
  • references/quality-gate.md
  • references/tables-and-matrices.md
  • references/tooltips-and-annotations.md
  • references/visual-colors.md
Commands it runs
pbir add title "Report.Report/Page.Page" "Page Title" --width 500
More from power-bi-agentic-development
All skills →
About this skill
What does the pbi-report-design skill do?

The Power BI report design canon covering design identity, visual hierarchy and the 3-30-300 rule, layout/spacing/alignment, color discipline, chart selection, KPI and card design, tables and matrices, accessibility, and the closing design gate. The shared reference home for report design judgment, routed to by the create-pbi-report, pbir-cli, review-report, modifying-theme-json, and custom-visual skills. Load when committing a design identity or making a design, layout, color, chart-selection, or accessibility decision for a report.

How do I install it?

Run `npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From data-goblin/power-bi-agentic-development, a repository with 833 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going