power-bi-theme

---
name: power-bi-theme
version: 26.40.3
description: 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, then hands applying to reports:modifying-theme-json, which also owns editing or enforcing a live theme.
---

# Power BI Theme

A general-purpose skill for choosing a Power BI report theme **visually** and applying
it to a project. It ships with a library of starter theme JSON files and a generator
that renders every theme as a realistic mock report so the user can pick by sight,
not by reading hex codes.

## Layout

```
power-bi-theme/
  themes/                       # The theme library (one .json per theme). Add more here.
  scripts/generate_gallery.py   # Scans a themes folder -> self-contained gallery.html
  reference/apply-to-pbip.md    # Full apply + enforce + validate workflow & manual fallback
```

The library is general-use: it is **not** tied to any one project. New `*.json` themes
dropped into `themes/` (or any folder passed with `--themes-dir`) appear automatically.

## Workflow

### Step 1 — Generate and open the visual gallery

```bash
python "${CLAUDE_PLUGIN_ROOT}/skills/power-bi-theme/scripts/generate_gallery.py" --open
```

This scans `themes/`, renders each theme as a mock Power BI report (page background,
KPI cards, bar chart, donut, and the full data-color strip — all using that theme's own
colors), writes `themes/powerbi-theme-gallery.html`, and opens it in the browser.

- The gallery has **Dark / Light filters** and a **search box**.
- Add project-local themes to the comparison with `--themes-dir "<folder>"` (it scans
  recursively for any JSON containing a `dataColors` array).
- Custom output path: `--output "<path>.html"`.

Tell the user: *browse the gallery, click **Use this theme** on your favorite, then tell
me which one.* The button copies `Apply Power BI theme: <name>` to the clipboard.

### Step 2 — User picks a theme

The user names a theme (e.g. *"Apply Power BI theme: Theme 7 - Dark"*). Locate the
matching file in the library:

```bash
# find the file whose "name" matches, or by filename
ls "${CLAUDE_PLUGIN_ROOT}/skills/power-bi-theme/themes/" | grep -i "theme 7 - dark"
```

If the name is ambiguous (Dark vs Light), confirm which variant.

### Step 3 — Apply to the current PBIP / PBIR project

Applying is owned by the **`reports:modifying-theme-json`** skill — do not duplicate the
apply logic here. Hand it two things and follow its Apply / Enforce / Validate workflow:

- the chosen library JSON: `${CLAUDE_PLUGIN_ROOT}/skills/power-bi-theme/themes/<name>.json`
- the target report folder (`*.Report` containing `definition/report.json`; ask the user
  for its path if none is in the working directory)

That skill registers the template, applies it, clears stale visual-level overrides
(keeping CF), validates, and covers the **close-and-reopen-in-Desktop** requirement
(Desktop reads custom themes from `RegisteredResources` only at open).

Manual fallback if neither the `pbir` CLI nor that skill is available:
`reference/apply-to-pbip.md`.

## Notes

- **Dark vs Light** is inferred from each theme's page-background luminance, so the badge
  is correct even if the filename doesn't say "Dark"/"Light".
- The gallery is fully self-contained (theme data is embedded) — it works by double-click,
  no server, and can be shared as a single HTML file.
- For deep theme *authoring/auditing* (visualStyles cascade, compliance, re-theming),
  defer to the `reports:modifying-theme-json` and `reports:pbir-cli` skills; this skill is
  focused on **choosing** a theme and dropping it into a project.

• SKILL.md 4 KB
• reference/apply-to-pbip.md 3 KB
• scripts/generate_gallery.py 18 KB
• themes/Theme 1 - Dark.json 6 KB
• themes/Theme 1 - Light.json 2 KB
• themes/Theme 10 - Dark.json 2 KB
• themes/Theme 10 - Light.json 2 KB
• themes/Theme 11 - Dark.json 2 KB
• themes/Theme 11 - Light.json 2 KB
• themes/Theme 12 - Dark.json 2 KB
• themes/Theme 12 - Light.json 2 KB
• themes/Theme 13 - Dark.json 2 KB
• themes/Theme 13 - Light.json 2 KB
• themes/Theme 14 - Dark.json 2 KB
• themes/Theme 14 - Light.json 2 KB
• themes/Theme 15 - Dark.json 2 KB
• themes/Theme 15 - Light.json 2 KB
• themes/Theme 16 - Dark.json 2 KB
• themes/Theme 16 - Light.json 2 KB
• themes/Theme 17 - Dark.json 2 KB
• themes/Theme 17 - Light.json 2 KB
• themes/Theme 18 - Dark.json 2 KB
• themes/Theme 18 - Light.json 2 KB
• themes/Theme 19 - Dark.json 2 KB
• themes/Theme 19 - Light.json 2 KB
• themes/Theme 2 - Dark.json 2 KB
• themes/Theme 2 - Light.json 2 KB
• themes/Theme 20 - Dark.json 2 KB
• themes/Theme 20 - Light.json 2 KB
• themes/Theme 21 - Dark.json 2 KB
• themes/Theme 21 - Light.json 2 KB
• themes/Theme 22 - Dark.json 2 KB
• themes/Theme 22 - Light.json 2 KB
• themes/Theme 23 - Dark.json 2 KB
• themes/Theme 23 - Light.json 2 KB
• themes/Theme 24 - Dark.json 2 KB
• themes/Theme 24 - Light.json 2 KB
• themes/Theme 3 - Dark.json 2 KB
• themes/Theme 3 - Light.json 2 KB
• themes/Theme 4 - Dark.json 2 KB
• themes/Theme 4 - Light.json 2 KB
• themes/Theme 5 - Dark.json 2 KB
• themes/Theme 5 - Light.json 2 KB
• themes/Theme 6 - Dark.json 2 KB
• themes/Theme 6 - Light.json 2 KB
• themes/Theme 7 - Dark.json 2 KB
• themes/Theme 7 - Light.json 2 KB
• themes/Theme 8 - Dark.json 2 KB
• themes/Theme 8 - Light.json 2 KB
• themes/Theme 9 - Dark.json 2 KB
• themes/Theme 9 - Light.json 2 KB