pbi-report-design — Claude Code skill: Power BI report design canon
pbi-report-design is a Claude Code skill that defines Power BI report design rules and is loaded by other skills before layout or theme decisions.
GPL-3.0 ★ 1,104 updated 2026-10-28
/plugin marketplace add data-goblin/power-bi-agentic-development
/plugin install reports@power-bi-agentic-developmentWhat pbi-report-design does
The skill defines design rules for Power BI reports: the 3-30-300 rule (important content in the top-left, details in the bottom-right), alignment and equal spacing between visuals, choosing a tone (restrained, corporate, editorial, technical) and signature (a recurring element across all pages), routing each page to one shape based on the question it answers (summary, monitoring, exploration, comparison, narrative).
Colors come from the theme rather than inline hex codes, so the identity propagates across the report. Fonts are Segoe UI and Segoe UI Semibold. The skill requires the pbir tool for any report mutations; if an operation is unavailable, work stops. Before modifying layout, the skill checks actual page dimensions from page.json to avoid exceeding bounds.
Called by create-pbi-report, pbir-cli, review-report, modifying-theme-json, and custom-visual skills before design, layout, color, chart-selection, or accessibility decisions.
What it helps with
- lock report design identity before layout work
- align visuals and make spacing equal
- choose the right chart for a specific question
- enforce color discipline through the theme
- route a page to one shape based on its task
Example prompts for the agent
- Lock the tone to
corporateand add a header band signature to the report - Check spacing equality between visuals on this page
- Choose a chart to compare trends across categories
How to install pbi-report-design
1Plugin marketplace
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install reports@power-bi-agentic-developmentThis installs the whole reports plugin with all its skills
2Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design -a claude-code3Manually: put the files in place
~/.claude/skills/pbi-report-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pbi-report-design/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design -a codex2Manually: put the files in place
.agents/skills/pbi-report-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design -a cursor2Manually: put the files in place
.cursor/skills/pbi-report-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install data-goblin/power-bi-agentic-development plugins/reports/skills/pbi-report-design2Manually: put the files in place
.github/skills/pbi-report-design/SKILL.md1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/reports/skills/pbi-report-designManually: put the files in place
.devin/skills/pbi-report-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pbi-report-design
How to install pbi-report-design in Claude Code?
Run /plugin marketplace add data-goblin/power-bi-agentic-development, then /plugin install reports@power-bi-agentic-development. Or use npx skills add data-goblin/power-bi-agentic-development --skill pbi-report-design -a claude-code, the file appears in ~/.claude/skills/pbi-report-design/SKILL.md.
What does pbi-report-design do?
The skill defines Power BI report design rules: the 3-30-300 hierarchy, tone and signature choice, layout with equal spacing, chart selection, color discipline through the theme, and page routing by shape. Other skills call it before design decisions.
Why does the skill require the pbir tool?
The skill requires pbir for any report changes. If the tool is unavailable or lacks an operation, work stops and the gap is reported.