Skip to content
Skills Library
Data & analytics · Review & audit

modifying-theme-json

/modifying-theme-json

Design, enforce, audit, and validate Power BI report themes through the pbir CLI. Invoke when a report uses a default or minimal theme, visuals have inconsistent formatting or many local overrides, or the user asks to create, copy, apply, standardize, rebrand, audit, or validate a theme; change theme colors or typography; define style presets; promote visual formatting into the theme; clear overrides; or improve theme compliance.

Licence
GPL-3.0
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
53
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

GPL-3.0, otwarta.

What it does and when to use it

Design, enforce, audit, and validate Power BI report themes through the pbir CLI. Invoke when a report uses a default or minimal theme, visuals have inconsistent formatting or many local overrides, or the user asks to create, copy, apply, standardize, rebrand, audit, or validate a theme; change theme colors or typography; define style presets; promote visual formatting into the theme; clear overrides; or improve theme compliance.

Original author description

Design, enforce, audit, and validate Power BI report themes through the pbir CLI. Invoke when a report uses a default or minimal theme, visuals have inconsistent formatting or many local overrides, or the user asks to create, copy, apply, standardize, rebrand, audit, or validate a theme; change theme colors or typography; define style presets; promote visual formatting into the theme; clear overrides; or improve theme compliance.

How it works

  1. Non-negotiable tooling rule
  2. Why themes matter
  3. Formatting cascade
  4. Audit before changing
  5. Design rules
  6. Author through pbir
  7. Promote a good visual into the theme
  8. Enforce theme inheritance
  9. Copy or replace a theme
  10. Validate and render
Original SKILL.md headings · 138 lines, 806 words
SKILL.md preview
---
name: modifying-theme-json
description: Design, enforce, audit, and validate Power BI report themes through the pbir CLI. Invoke when a report uses a default or minimal theme, visuals have inconsistent formatting or many local overrides, or the user asks to create, copy, apply, standardize, rebrand, audit, or validate a theme; change theme colors or typography; define style presets; promote visual formatting into the theme; clear overrides; or improve theme compliance.
---

# Power BI report themes

Use this skill for theme design and compliance decisions. Use the `pbir-cli` skill for command details.

## Non-negotiable tooling rule

Use `pbir` for every report and theme mutation. Never edit `theme.json`, `visual.json`, serialized `.Theme` fragments, or other report JSON directly. Never fall back to `jq`, shell replacement, or a JSON-editing skill. If `pbir` lacks the required operation, stop and report the missing capability.

Read JSON only through `pbir cat`, `pbir get`, or read-only examples. Prefer structured CLI inspection commands because they explain the formatting cascade and usage.

## Why themes matter

A theme centralizes formatting that would otherwise drift across visuals. It should own repeated choices such as:

- Data-series palette and semantic good/neutral/bad colors
- Background, foreground, structural, gradient, hyperlink, and null colors
- Font family, size, weight, and hierarchy
- Wildcard container defaults such as titles, borders, padding, and shadows
- Visual-type defaults for cards, slicers, charts, tables, textboxes, and images

Visual-level overrides should remain only for content-specific exceptions or conditional formatting. Theme-first reports are easier to rebrand, diff, and maintain.

## Formatting cascade

```text
Power BI defaults
  -> theme wildcard defaults
  -> theme visual-type defaults
  -> selected style preset
  -> visual instance overrides
```

The last layer wins. Diagnose unexpected rendering with `pbir visuals format`, which reports the effective value and source; do not inspect or patch `visual.json`.

## Audit before changing

```bash
pbir theme colors "Report.Report"
pbir theme fonts "Report.Report"
pbir color list "Report.Report"
pbir fonts list "Report.Report"
pbir visuals format "Report.Report/Page.Page/Visual.Visual"
pbir bpa run "Report.Report"
```

Look for hard-coded colors, repeated visual-level font or container overrides, inconsistent visual types, weak contrast, excessive palette size, and sentiment colors that change meaning between visuals.

## Design rules

1. Limit the data palette to the number of categories the report genuinely needs.
2. Reserve saturated accent colors for focus, selection, exceptions, and key comparisons.
3. Assign one stable meaning to each semantic color. Good, neutral, bad, selected, disabled, and hyperlink colors must not trade roles across pages.
4. Keep structural colors quiet. Axes, borders, gridlines, and backgrounds should support reading rather than compete with data.
5. Use one portable font family and a small type scale. Express hierarchy through size and weight, not many colors.
6. Prefer wildcard defaults, then visual-type defaults, then rare instance overrides.
7. Preserve accessible contrast and never rely on hue alone to communicate state.

## Author through `pbir`

Start from a valid template or the report's existing theme; do not author an empty theme.

```bash
# Apply a known base when requested
pbir theme list-templates
pbir theme apply-template "Report.Report" sqlbi

# Set palette and semantic colors
pbir theme set-colors "Report.Report" \
  --data-colors '["#1971C2","#F08C00","#2F9E44","#7048E8"]' \
  --good "#2E7D32" --neutral "#6B7280" --bad "#C62828" \
  --background "#FFFFFF" --foreground "#252525"

# Set typography by semantic level
pbir theme set-fonts "Report.Report" title --font-face "Segoe UI Semibold" --font-size 14
pbir theme set-fonts "Report.Report" label --font-face "Segoe UI" --font-size 10
pbir theme set-fonts "Report.Report" callout --font-face "Segoe UI Semibold" --font-size 32

# Set repeated formatting at theme level
pbir theme set-formatting "Report.Report" "*.*.dropShadow.show" --value false
pbir theme set-formatting "Report.Report" "*.*.border.show" --value false
pbir theme set-formatting "Report.Report" "card.*.title.fontSize" --value 14
```

Run `pbir schema describe <visualType> <object>` before authoring unfamiliar formatting properties.

## Promote a good visual into the theme

```bash
pbir theme push-visual "Report.Report/Page.Page/BestCard.Visual" --dry-run
pbir theme push-visual "Report.Report/Page.Page/BestCard.Visual"
```

Use this when a well-designed instance should become the default for its visual type. Inspect the dry run first so content-specific formatting is not promoted accidentally.

## Enforce theme inheritance

Clearing overrides is destructive and must be confirmed with the user. Preserve conditional formatting unless the user explicitly wants it removed.

```bash
pbir visuals clear-formatting "Report.Report/**/*.Visual" --keep-cf --dry-run -f
pbir visuals clear-formatting "Report.Report/**/*.Visual" --keep-cf -f
pbir theme colors "Report.Report" --normalize
pbir theme colors "Report.Report" --normalize --apply
```

For selective cleanup, use the flags documented by `pbir visuals clear-formatting --help` rather than broad file edits.

## Copy or replace a theme

```bash
pbir cp "Source.Report/theme" "Target.Report/theme" -f
pbir theme validate "Target.Report"
```

After a theme swap, clear stale visual overrides, normalize surviving color literals, and inspect foreground/background polarity so text does not become invisible.

## Validate and render

Use one confidence pass after a coherent batch:

```bash
pbir theme validate "Report.Report"
pbir validate "Report.Report" --all
pbir desktop refresh "Report.Report"
pbir desktop screenshot "Report.Report" --all --output-dir screenshots
```

Desktop refresh does not reload theme resources. Close and reopen the report before judging theme changes, then capture screenshots. If Desktop is unavailable, ask before publishing to a sandbox workspace for rendered verification.

## Detailed references

- `references/style-presets.md`: named style presets per visual type, default preset, selecting a preset on visuals
- `pbir-cli` -> `references/modifying-theme.md`: colors, fonts, formatting, normalization, validation
- `pbir-cli` -> `references/apply-theme.md`: templates, copying, clearing overrides
- `pbir-cli` -> `references/format-visuals.md`: cascade inspection and property discovery
- `pbi-report-design`: layout, restrained color use, hierarchy, and accessibility
Files in this package (53)
  • SKILL.md 7 KB
  • examples/DataGoblins2021.json 14 KB
  • examples/Fluent2-CY26SU03.json 87 KB
  • examples/visualTypes/actionButton.md 2 KB
  • examples/visualTypes/advancedSlicerVisual.md 2 KB
  • examples/visualTypes/aiNarratives.md 1 KB
  • examples/visualTypes/areaChart.md 2 KB
  • examples/visualTypes/azureMap.md 2 KB
  • examples/visualTypes/barChart.md 3 KB
  • examples/visualTypes/bookmarkNavigator.md 3 KB
  • examples/visualTypes/card.md 1 KB
  • examples/visualTypes/cardVisual.md 2 KB
  • examples/visualTypes/clusteredBarChart.md 3 KB
  • examples/visualTypes/clusteredColumnChart.md 2 KB
  • examples/visualTypes/columnChart.md 3 KB
  • examples/visualTypes/decompositionTreeVisual.md 3 KB
  • examples/visualTypes/donutChart.md 2 KB
  • examples/visualTypes/filledMap.md 2 KB
  • examples/visualTypes/filter.md 1 KB
  • examples/visualTypes/funnel.md 2 KB
  • examples/visualTypes/gauge.md 2 KB
  • examples/visualTypes/group.md 1 KB
  • examples/visualTypes/hundredPercentStackedAreaChart.md 2 KB
  • examples/visualTypes/hundredPercentStackedBarChart.md 3 KB
  • examples/visualTypes/hundredPercentStackedColumnChart.md 3 KB
  • examples/visualTypes/image.md 1 KB
  • examples/visualTypes/keyDriversVisual.md 2 KB
  • examples/visualTypes/kpi.md 2 KB
  • examples/visualTypes/lineChart.md 2 KB
  • examples/visualTypes/lineClusteredColumnComboChart.md 2 KB
  • examples/visualTypes/lineStackedColumnComboChart.md 2 KB
  • examples/visualTypes/listSlicer.md 2 KB
  • examples/visualTypes/map.md 2 KB
  • examples/visualTypes/multiRowCard.md 2 KB
  • examples/visualTypes/pieChart.md 2 KB
  • examples/visualTypes/pivotTable.md 3 KB
  • examples/visualTypes/pythonVisual.md 2 KB
  • examples/visualTypes/qnaVisual.md 3 KB
  • examples/visualTypes/rdlVisual.md 2 KB
  • examples/visualTypes/ribbonChart.md 3 KB
  • examples/visualTypes/scatterChart.md 2 KB
  • examples/visualTypes/scorecard.md 2 KB
  • examples/visualTypes/scriptVisual.md 2 KB
  • examples/visualTypes/shape.md 1 KB
  • examples/visualTypes/shapeMap.md 1 KB
  • examples/visualTypes/slicer.md 2 KB
  • examples/visualTypes/stackedAreaChart.md 2 KB
  • examples/visualTypes/tableEx.md 2 KB
  • examples/visualTypes/textSlicer.md 2 KB
  • examples/visualTypes/textbox.md 1 KB
  • examples/visualTypes/treemap.md 2 KB
  • examples/visualTypes/waterfallChart.md 3 KB
  • references/style-presets.md 4 KB

Versions

RepositoryScoreLicence
This page · data-goblin/power-bi-agentic-development100GPL-3.0
insightfulanalytics/pbi_agentic_dev100GPL-3.0

Database snapshot: 13.11.2026 · package version 87bbba820022 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100pbir-format
    Format reference for Power BI Enhanced Report (PBIR) JSON schemas and patterns. Automatically invoke when the user asks about PBIR JSON structure, visual.json properties, PBIR expressions, objects vs visualContainerObjects, theme inheritance, conditional formatting patterns,…
  • 100power-bi-themes
    Apply, inspect, and compare Power BI report themes and conditional formatting rules using pbi-cli. Invoke this skill whenever the user mentions "theme", "colours", "colors", "branding", "dark mode", "corporate theme", "styling", "conditional formatting", "colour scale",…
  • 100power-bi-theme
    Browse, visually compare and pick Power BI report themes. Use when the user wants to "pick a theme", "see all my themes", "preview themes", "compare themes", "open the theme gallery" or apply a preset theme. Renders every theme in the library as a mock report in an HTML gallery,…
  • 90Power BI Report
    Scaffold, validate, preview, and manage Power BI PBIR report projects using pbi-cli. Invoke this skill whenever the user mentions "create report", "new report", "PBIR", "scaffold", "validate report", "report structure", "preview report", "report info", "reload Desktop", "convert…
  • 100power-bi-report
    Scaffold, validate, preview, and manage Power BI PBIR report projects using pbi-cli. Invoke this skill whenever the user mentions "create report", "new report", "PBIR", "scaffold", "validate report", "report structure", "preview report", "report info", "reload Desktop", "convert…
  • 100create-pbi-report
    Step-by-step workflow for creating complete Power BI reports from scratch using pbir CLI. Covers model discovery, report creation, page layout, theme setup, visual placement, field binding, filtering, formatting, validation, and publishing. Automatically invoke when the user…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.