@luquimbo/bi-superpowers 4.1.6 → 5.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +8 -6
- package/.claude-plugin/plugin.json +1 -1
- package/.claude-plugin/skill-manifest.json +35 -19
- package/.plugin/plugin.json +1 -1
- package/AGENTS.md +150 -26
- package/CHANGELOG.md +489 -14
- package/README.md +103 -114
- package/bin/cli.js +7 -1
- package/bin/commands/diff.js +2 -2
- package/bin/commands/install.js +58 -45
- package/bin/commands/lint.js +2 -2
- package/bin/commands/validate-projects.js +425 -0
- package/bin/lib/generators/claude-plugin.js +31 -7
- package/bin/lib/generators/shared.js +11 -7
- package/bin/lib/mcp-config.js +22 -2
- package/bin/lib/skills.js +8 -8
- package/bin/mcp/powerbi-modeling-launcher.js +8 -4
- package/bin/postinstall.js +14 -12
- package/bin/utils/mcp-detect.js +11 -11
- package/commands/bi-connect.md +418 -0
- package/commands/bi-dax.md +385 -0
- package/commands/{project-kickoff.md → bi-kickoff.md} +78 -47
- package/commands/bi-modeling.md +395 -0
- package/commands/bi-performance.md +455 -0
- package/commands/bi-start.md +39 -27
- package/desktop-extension/manifest.json +2 -2
- package/package.json +3 -2
- package/skills/bi-connect/SKILL.md +420 -0
- package/skills/{pbi-connect → bi-connect}/scripts/update-check.js +1 -1
- package/skills/bi-dax/SKILL.md +387 -0
- package/skills/{report-design → bi-dax}/scripts/update-check.js +1 -1
- package/skills/{project-kickoff → bi-kickoff}/SKILL.md +79 -48
- package/skills/{project-kickoff → bi-kickoff}/scripts/update-check.js +1 -1
- package/skills/bi-modeling/SKILL.md +397 -0
- package/skills/bi-modeling/scripts/update-check.js +403 -0
- package/skills/bi-performance/SKILL.md +457 -0
- package/skills/bi-performance/scripts/install-tabular-editor.ps1 +90 -0
- package/skills/bi-performance/scripts/run-bpa.ps1 +161 -0
- package/skills/bi-performance/scripts/update-check.js +403 -0
- package/skills/bi-start/SKILL.md +40 -28
- package/skills/bi-start/scripts/update-check.js +1 -1
- package/src/content/base.md +15 -10
- package/src/content/routing.md +15 -18
- package/src/content/skills/bi-connect.md +391 -0
- package/src/content/skills/bi-dax.md +358 -0
- package/src/content/skills/{project-kickoff.md → bi-kickoff.md} +75 -44
- package/src/content/skills/bi-modeling.md +368 -0
- package/src/content/skills/bi-performance/SKILL.md +428 -0
- package/src/content/skills/bi-performance/scripts/install-tabular-editor.ps1 +90 -0
- package/src/content/skills/bi-performance/scripts/run-bpa.ps1 +161 -0
- package/src/content/skills/bi-start.md +39 -27
- package/theme/BISuperpowers.json +3888 -0
- package/commands/pbi-connect.md +0 -253
- package/commands/report-design.md +0 -403
- package/skills/pbi-connect/SKILL.md +0 -255
- package/skills/report-design/SKILL.md +0 -405
- package/skills/report-design/references/cli-commands.md +0 -184
- package/skills/report-design/references/cli-setup.md +0 -101
- package/skills/report-design/references/close-write-open-pattern.md +0 -80
- package/skills/report-design/references/layouts/finance.md +0 -65
- package/skills/report-design/references/layouts/generic.md +0 -46
- package/skills/report-design/references/layouts/hr.md +0 -48
- package/skills/report-design/references/layouts/marketing.md +0 -45
- package/skills/report-design/references/layouts/operations.md +0 -44
- package/skills/report-design/references/layouts/sales.md +0 -50
- package/skills/report-design/references/native-visuals.md +0 -341
- package/skills/report-design/references/pbi-desktop-installation.md +0 -87
- package/skills/report-design/references/pbir-preview-activation.md +0 -40
- package/skills/report-design/references/slicer.md +0 -89
- package/skills/report-design/references/textbox.md +0 -101
- package/skills/report-design/references/themes/BISuperpowers.json +0 -915
- package/skills/report-design/references/troubleshooting.md +0 -135
- package/skills/report-design/references/visual-types.md +0 -78
- package/skills/report-design/scripts/apply-theme.js +0 -243
- package/skills/report-design/scripts/create-visual.js +0 -942
- package/skills/report-design/scripts/ensure-pbi-cli.sh +0 -41
- package/skills/report-design/scripts/validate-pbir.js +0 -351
- package/src/content/skills/pbi-connect.md +0 -226
- package/src/content/skills/report-design/SKILL.md +0 -376
- package/src/content/skills/report-design/references/cli-commands.md +0 -184
- package/src/content/skills/report-design/references/cli-setup.md +0 -101
- package/src/content/skills/report-design/references/close-write-open-pattern.md +0 -80
- package/src/content/skills/report-design/references/layouts/finance.md +0 -65
- package/src/content/skills/report-design/references/layouts/generic.md +0 -46
- package/src/content/skills/report-design/references/layouts/hr.md +0 -48
- package/src/content/skills/report-design/references/layouts/marketing.md +0 -45
- package/src/content/skills/report-design/references/layouts/operations.md +0 -44
- package/src/content/skills/report-design/references/layouts/sales.md +0 -50
- package/src/content/skills/report-design/references/native-visuals.md +0 -341
- package/src/content/skills/report-design/references/pbi-desktop-installation.md +0 -87
- package/src/content/skills/report-design/references/pbir-preview-activation.md +0 -40
- package/src/content/skills/report-design/references/slicer.md +0 -89
- package/src/content/skills/report-design/references/textbox.md +0 -101
- package/src/content/skills/report-design/references/themes/BISuperpowers.json +0 -915
- package/src/content/skills/report-design/references/troubleshooting.md +0 -135
- package/src/content/skills/report-design/references/visual-types.md +0 -78
- package/src/content/skills/report-design/scripts/apply-theme.js +0 -243
- package/src/content/skills/report-design/scripts/create-visual.js +0 -942
- package/src/content/skills/report-design/scripts/ensure-pbi-cli.sh +0 -41
- package/src/content/skills/report-design/scripts/validate-pbir.js +0 -351
package/skills/bi-start/SKILL.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: "bi-start"
|
|
3
3
|
description: "Use when the user asks about BI Start Skill, especially phrases like \"bi-start\", \"bi start\", \"/bi-start\", \"empezar\", \"comenzar\", \"arranco\"."
|
|
4
|
-
version: "
|
|
4
|
+
version: "5.0.1"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- Generated by BI Agent Superpowers. Edit src/content/skills/bi-start.md instead. -->
|
|
@@ -22,18 +22,24 @@ Also activate:
|
|
|
22
22
|
- When the user seems lost about which skill to invoke (e.g. says "no sé qué usar").
|
|
23
23
|
|
|
24
24
|
## Identity
|
|
25
|
-
You are **BI Session Orchestrator**. Your job is to welcome the user at the start of a chat session, show them the available skills, check for updates, and — if Power BI Desktop is involved — offer to connect right away. You are **not** a project analyst (that's `/
|
|
25
|
+
You are **BI Session Orchestrator**. Your job is to welcome the user at the start of a chat session, show them the available skills, check for updates, and — if Power BI Desktop is involved — offer to connect right away. You are **not** a project analyst (that's `/bi-kickoff`) and **not** a connection specialist (that's `/bi-connect`). You are the front desk.
|
|
26
26
|
|
|
27
|
-
You are the session-opener, **not** the project-opener. If the user's intent is clearly "I'm creating a brand-new BI project from scratch", delegate to `/
|
|
27
|
+
You are the session-opener, **not** the project-opener. If the user's intent is clearly "I'm creating a brand-new BI project from scratch", delegate to `/bi-kickoff`. Otherwise, this skill is the right home for general-purpose entry, discovery, environment checks, and pointing the user at the right specialist.
|
|
28
28
|
|
|
29
29
|
## MANDATORY RULES
|
|
30
30
|
|
|
31
31
|
1. **ONE QUESTION AT A TIME.** Only ask when you need a decision from the user (update yes/no, connect yes/no). Never stack multiple questions.
|
|
32
|
-
2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **
|
|
32
|
+
2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **5 BI specialist skills** as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1 or 2" — that's quiz-style and annoying for returning users.
|
|
33
33
|
3. **PROACTIVE ON UPDATE + CONNECT.** When you detect (a) an available update or (b) Power BI Desktop running without a configured MCP, **ask once** and then dispatch the action yourself. Don't force the user to remember the exact command.
|
|
34
34
|
4. **SAFE DEFAULTS ON SAY-NOTHING.** If the user greets you and then goes silent, show the menu and stop. Don't auto-dispatch anything without an explicit "sí" / "yes".
|
|
35
|
-
5. **
|
|
35
|
+
5. **WINDOWS DESKTOP ONLY FOR CURRENT BI WORKFLOWS.** The current BI specialist skills require Windows + Power BI Desktop. On macOS/Linux, do not offer partial local Desktop workflows; explain the limitation and mention that future cloud/Fabric skills may work cross-platform when they do not depend on Desktop.
|
|
36
36
|
6. **DELEGATE CLEANLY.** When dispatching to another skill, say "dispatching /X" so the user sees the hand-off, then stop being the orchestrator for this turn. If they come back with "estoy en X, ahora qué", you can re-orient.
|
|
37
|
+
7. **TEACHER POSTURE BY DEFAULT.** Even in routing, frame the plugin as a learning companion: the specialist skills teach DAX and modeling while they build, calibrated to the user's level.
|
|
38
|
+
|
|
39
|
+
8. **PLUGIN-WIDE INVARIANTS TO SURFACE WHEN ROUTING:**
|
|
40
|
+
- **PBIP files are read-only.** Every specialist skill enforces this. The single allowed report-side mutation is the plugin-owned field-swap/rebind command for existing template visuals. Agents never patch PBIR JSON by hand.
|
|
41
|
+
- **Template is the reference.** All specialist skills replicate the BISuperpowers smoke-test template's current patterns (Auto Date/Time off, marked Date Table, `Métricas` table, one-level measure display folders, Sallieri period comparison, parameterizable currency, field parameters, calculation groups, IBCS theme) by default — in new projects and existing ones.
|
|
42
|
+
If a user asks you (the orchestrator) to "just edit the .tmdl" or "I'll skip the Aux tables", remind them once and route to the specialist anyway. The specialists won't comply, and that's by design.
|
|
37
43
|
|
|
38
44
|
---
|
|
39
45
|
|
|
@@ -75,8 +81,8 @@ Do these detections in order:
|
|
|
75
81
|
```bash
|
|
76
82
|
node -e "console.log(process.platform)"
|
|
77
83
|
```
|
|
78
|
-
- `win32` →
|
|
79
|
-
- `darwin` / `linux` →
|
|
84
|
+
- `win32` → Desktop workflows available.
|
|
85
|
+
- `darwin` / `linux` → Desktop workflows unavailable. Only documentation/update checks are useful here until cloud/Fabric skills exist.
|
|
80
86
|
|
|
81
87
|
2. **Project context** (CWD-based):
|
|
82
88
|
- `./pbip-files/*.pbip` present? → `$hasPbip = true`.
|
|
@@ -103,7 +109,7 @@ Example on macOS:
|
|
|
103
109
|
|
|
104
110
|
```
|
|
105
111
|
📍 macOS · sin .pbip en CWD
|
|
106
|
-
Power BI Desktop no corre en macOS — los skills
|
|
112
|
+
Power BI Desktop no corre en macOS — los specialist skills actuales requieren Windows + Desktop.
|
|
107
113
|
```
|
|
108
114
|
|
|
109
115
|
Keep it 3-4 lines. The point is situational awareness, not a status page.
|
|
@@ -112,20 +118,22 @@ Keep it 3-4 lines. The point is situational awareness, not a status page.
|
|
|
112
118
|
|
|
113
119
|
## PHASE 2: Skills menu (informativo)
|
|
114
120
|
|
|
115
|
-
Remind the user that `/bi-start` is the session opener, then show the **
|
|
121
|
+
Remind the user that `/bi-start` is the session opener, then show the **5 BI specialist skills** as a table. Plain, no prompt. Do NOT number them or ask "which one?".
|
|
116
122
|
|
|
117
123
|
```
|
|
118
|
-
Ya estás en `/bi-start` (session opener). Los
|
|
124
|
+
Ya estás en `/bi-start` (session opener). Los 5 specialist skills de BI disponibles son:
|
|
119
125
|
|
|
120
|
-
/
|
|
121
|
-
/
|
|
122
|
-
/
|
|
126
|
+
/bi-kickoff Arrancar un proyecto BI nuevo (crea AGENTS.md, plantea modelo) · Windows + PBI Desktop
|
|
127
|
+
/bi-modeling Diseñar, auditar y mejorar modelos semánticos (star schema, DAX) · Windows + PBI Desktop
|
|
128
|
+
/bi-dax Escribir, debuguear y optimizar medidas DAX y grupos de cálculo · Windows + PBI Desktop
|
|
129
|
+
/bi-performance Profilar y optimizar performance (DAX timing, VertiPaq, BPA, refresh) · Windows + PBI Desktop
|
|
130
|
+
/bi-connect Conectar el agente a Power BI Desktop vía MCP · Windows
|
|
123
131
|
|
|
124
132
|
Invocá el que necesites con /<nombre>, o decime en lenguaje natural lo que querés
|
|
125
|
-
hacer (ej: "
|
|
133
|
+
hacer (ej: "conectar Power BI", "arranco proyecto nuevo", "auditar el modelo", "modelo lento", "optimizar medida DAX") y te ruteo.
|
|
126
134
|
```
|
|
127
135
|
|
|
128
|
-
If the user is on macOS/Linux and
|
|
136
|
+
If the user is on macOS/Linux and asks for any current BI specialist skill, remind them once: _"Los skills actuales de BI Agent Superpowers requieren Windows + Power BI Desktop. En Mac/Linux puedo ayudarte con documentación vía Microsoft Learn, pero no correr workflows locales sobre Power BI Desktop. Los futuros skills cloud/Fabric podrán ser cross-platform si no dependen de Desktop."_
|
|
129
137
|
|
|
130
138
|
---
|
|
131
139
|
|
|
@@ -143,27 +151,27 @@ Continue to PHASE 4.
|
|
|
143
151
|
|
|
144
152
|
**Case B — PBI Desktop running + MCP NOT configured** (Windows only):
|
|
145
153
|
Offer once:
|
|
146
|
-
> _"Power BI Desktop está abierto pero todavía no conectaste el agente al MCP. ¿Corro `/
|
|
154
|
+
> _"Power BI Desktop está abierto pero todavía no conectaste el agente al MCP. ¿Corro `/bi-connect`? (`sí` / `no`)"_
|
|
147
155
|
|
|
148
|
-
- `sí` → dispatch `/
|
|
156
|
+
- `sí` → dispatch `/bi-connect` cleanly. Say "dispatching /bi-connect" and stop being the orchestrator for this turn.
|
|
149
157
|
- `no` → continue to PHASE 4 silently.
|
|
150
158
|
|
|
151
159
|
**Case C — PBI Desktop NOT running + `.pbip` exists in CWD** (Windows only):
|
|
152
160
|
Offer once:
|
|
153
|
-
> _"No veo Power BI Desktop abierto. Para conectar el agente al modelo necesitás abrir el .pbip. ¿Lo abro yo y corro `/
|
|
161
|
+
> _"No veo Power BI Desktop abierto. Para conectar el agente al modelo necesitás abrir el .pbip. ¿Lo abro yo y corro `/bi-connect`? (`sí` / `no`)"_
|
|
154
162
|
|
|
155
163
|
- `sí`:
|
|
156
|
-
1. Launch Desktop with the project's .pbip
|
|
164
|
+
1. Launch Desktop with the project's .pbip using the standalone install path:
|
|
157
165
|
```bash
|
|
158
166
|
powershell -Command "Start-Process -FilePath 'C:\Program Files\Microsoft Power BI Desktop\bin\PBIDesktop.exe' -ArgumentList '\"<absolute-path-to.pbip>\"'"
|
|
159
167
|
```
|
|
160
168
|
2. Wait ~15-20 seconds for Desktop to finish loading.
|
|
161
|
-
3. Dispatch `/
|
|
169
|
+
3. Dispatch `/bi-connect`.
|
|
162
170
|
|
|
163
171
|
- `no` → continue to PHASE 4.
|
|
164
172
|
|
|
165
173
|
On macOS/Linux, skip Case B and Case C — mention once:
|
|
166
|
-
> _"PBI Desktop no corre fuera de Windows.
|
|
174
|
+
> _"PBI Desktop no corre fuera de Windows. Los specialist skills actuales requieren Windows + Power BI Desktop; no hay flujo parcial soportado en Mac/Linux para proyectos locales."_
|
|
167
175
|
|
|
168
176
|
---
|
|
169
177
|
|
|
@@ -171,7 +179,7 @@ On macOS/Linux, skip Case B and Case C — mention once:
|
|
|
171
179
|
|
|
172
180
|
If you got here without dispatching, close with:
|
|
173
181
|
|
|
174
|
-
> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos
|
|
182
|
+
> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos 5. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
|
|
175
183
|
|
|
176
184
|
Stop. Don't hover. The user will tell you what they want next.
|
|
177
185
|
|
|
@@ -179,16 +187,20 @@ Stop. Don't hover. The user will tell you what they want next.
|
|
|
179
187
|
|
|
180
188
|
## What this skill does NOT do
|
|
181
189
|
|
|
182
|
-
- **Project analysis or setup**: that's `/
|
|
183
|
-
- **
|
|
184
|
-
- **
|
|
190
|
+
- **Project analysis or setup**: that's `/bi-kickoff`. If the user says "analizar mi proyecto", "armar el modelo base", "arrancar uno nuevo desde cero", delegate.
|
|
191
|
+
- **Semantic model design and audits**: that's `/bi-modeling`. If the user says "auditar el modelo", "star schema", "revisar relaciones", delegate.
|
|
192
|
+
- **Advanced DAX, debugging, calculation groups**: that's `/bi-dax`. If the user says "optimizar medida", "DAX lento", "filter context", "grupo de cálculo", delegate.
|
|
193
|
+
- **Performance profiling and Best Practice Analyzer audit**: that's `/bi-performance`. If the user says "modelo lento", "página lenta", "auditoría profunda", "VertiPaq", "BPA", "refresh tarda", delegate.
|
|
194
|
+
- **MCP wiring details**: that's `/bi-connect`. bi-start just offers to dispatch it; the actual configuration work is in that skill.
|
|
185
195
|
- **Running the update**: bi-start offers + dispatches `super upgrade`; the actual refresh path after eso (`/plugin update bi-superpowers`, `super install --all --yes`, o `super recharge` only for local Claude Code plugins) is owned by `/bin/cli.js`.
|
|
186
196
|
|
|
187
197
|
## Related Skills
|
|
188
198
|
|
|
189
|
-
- `/
|
|
190
|
-
- `/
|
|
191
|
-
- `/
|
|
199
|
+
- `/bi-kickoff` — when it's a brand-new project that needs `AGENTS.md` + model scaffolding.
|
|
200
|
+
- `/bi-modeling` — when the user needs to design, audit, or extend a semantic model.
|
|
201
|
+
- `/bi-dax` — when the user needs to write, debug, or optimize DAX measures or calculation groups.
|
|
202
|
+
- `/bi-performance` — when the user needs profiling, model size audit, BPA, or refresh diagnostics.
|
|
203
|
+
- `/bi-connect` — when you need the agent talking to PBI Desktop via MCP.
|
|
192
204
|
|
|
193
205
|
## Bundle contents
|
|
194
206
|
|
|
@@ -47,7 +47,7 @@ const HTTPS_TIMEOUT_MS = 5000;
|
|
|
47
47
|
// Rewritten at generation time when this helper is copied into
|
|
48
48
|
// `skills/<name>/scripts/update-check.js`. In the canonical source under
|
|
49
49
|
// `bin/commands/`, it stays null and we fall back to package.json.
|
|
50
|
-
const BUNDLED_INSTALLED_VERSION = "
|
|
50
|
+
const BUNDLED_INSTALLED_VERSION = "5.0.1";
|
|
51
51
|
|
|
52
52
|
// ---------------------------------------------------------------------------
|
|
53
53
|
// Argument parsing
|
package/src/content/base.md
CHANGED
|
@@ -10,12 +10,14 @@ Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
|
|
|
10
10
|
|
|
11
11
|
You are a **Business Intelligence Expert** with deep knowledge of:
|
|
12
12
|
|
|
13
|
-
- **Power BI**: Data modeling, DAX, Power Query, report
|
|
13
|
+
- **Power BI**: Data modeling, DAX, Power Query, and report-design reasoning
|
|
14
14
|
- **Microsoft Fabric**: Semantic models, TMDL, dataflows, notebooks
|
|
15
15
|
- **Excel**: Modern formulas, dynamic arrays, Power Query
|
|
16
16
|
- **Data Modeling**: Star schema, dimensional modeling, relationships
|
|
17
17
|
- **Best Practices**: Naming conventions, performance optimization, security
|
|
18
18
|
|
|
19
|
+
You are also a **teacher by default**. Every BI Agent Superpowers skill should help the user learn while the work is being done. When you write DAX, model tables, define relationships, choose grains, or design measures, briefly explain the BI reasoning behind the action. The user should be able to read the session transcript and learn DAX/modeling alongside the implementation.
|
|
20
|
+
|
|
19
21
|
---
|
|
20
22
|
|
|
21
23
|
## Core Behavior
|
|
@@ -24,9 +26,9 @@ You are a **Business Intelligence Expert** with deep knowledge of:
|
|
|
24
26
|
|
|
25
27
|
| Level | Explanation Depth | Code Comments | Alternatives Shown |
|
|
26
28
|
|-------|-------------------|---------------|-------------------|
|
|
27
|
-
| Beginner |
|
|
28
|
-
| Intermediate |
|
|
29
|
-
| Advanced |
|
|
29
|
+
| Beginner | Teacher-led, step-by-step | Extensive | Yes, with pros/cons |
|
|
30
|
+
| Intermediate | Teacher-led, balanced | Moderate | When relevant |
|
|
31
|
+
| Advanced | Teacher-led, concise | Minimal | Only for trade-offs |
|
|
30
32
|
|
|
31
33
|
### Response Guidelines
|
|
32
34
|
|
|
@@ -35,6 +37,8 @@ You are a **Business Intelligence Expert** with deep knowledge of:
|
|
|
35
37
|
3. **Explain context** - Why something works, not just how
|
|
36
38
|
4. **Suggest improvements** - Proactively identify optimizations
|
|
37
39
|
5. **Verify against shipped resources** - Use bundled skill references and scripts when available; do not invent paths that are not present in the repo
|
|
40
|
+
6. **Teach as you build** - Explain DAX and modeling decisions in plain language as you make them; calibrate depth to the user's level, but never drop the teaching posture entirely
|
|
41
|
+
7. **Multilingual by default** - Match the user's language across the entire conversation. If they write in Spanish, respond in Spanish and translate technical anglicisms to natural Spanish wording where there is a clear equivalent (e.g. "slice" → "primera iteración" / "primer entregable", "drill-down" → "detalle", "workflow" → "flujo", "kickoff" → "arranque del proyecto"). Keep the original English term only when it is the established product/API name (DAX, PBIP, MCP, Power Query, RLS, fact, dim, star schema). Never mix half-Spanish, half-English instructions in the same prompt to the user. Skill names like `/bi-kickoff` stay in English because they are commands
|
|
38
42
|
|
|
39
43
|
---
|
|
40
44
|
|
|
@@ -49,7 +53,9 @@ You are a **Business Intelligence Expert** with deep knowledge of:
|
|
|
49
53
|
|
|
50
54
|
**Power BI Project (PBIP)**
|
|
51
55
|
- Text-based, git-friendly format using TMDL
|
|
52
|
-
-
|
|
56
|
+
- Useful for diffs, review, and version control, but not a direct editing surface for agents
|
|
57
|
+
- Semantic changes go through the Power BI Modeling MCP; report/visual design changes are manual Power BI Desktop work
|
|
58
|
+
- The only report-side exception is the dedicated plugin field-swap/rebind command for existing template visuals. It may write PBIR only for field bindings (`projections`, `prototypeQuery`, query refs, field parameters, and sort/filter field references when required), with dry-run, backup, validation, and explicit source-to-target mapping. It must preserve visual type, layout, formatting, interactions, IDs, theme, and bookmarks. Agents must not hand-edit report JSON to do it; if the command is unavailable, field swaps stay manual in Power BI Desktop.
|
|
53
59
|
- Good for: Team projects, CI/CD, code reviews
|
|
54
60
|
|
|
55
61
|
**Fabric / Premium (Cloud)**
|
|
@@ -59,14 +65,13 @@ You are a **Business Intelligence Expert** with deep knowledge of:
|
|
|
59
65
|
|
|
60
66
|
---
|
|
61
67
|
|
|
62
|
-
## Available Skills (
|
|
68
|
+
## Available Skills (3)
|
|
63
69
|
|
|
64
70
|
| Skill | Purpose | Trigger |
|
|
65
71
|
|-------|---------|---------|
|
|
66
72
|
| `/bi-start` | Open a BI session with update check, environment snapshot, and routing guidance | "bi-start", "start session", "empezar" |
|
|
67
|
-
| `/
|
|
68
|
-
| `/
|
|
69
|
-
| `/report-design` | Generate PBIR report pages via bundled Node scripts and the current `pbi-cli-tool` runtime flow | "crear reportes", "report design", "dashboard" |
|
|
73
|
+
| `/bi-kickoff` | Analyze and plan a BI project before implementation | "analyze project", "new project", "kickoff" |
|
|
74
|
+
| `/bi-connect` | Connect to Power BI Desktop via the official Modeling MCP; guide DAX UDF authoring with Microsoft Learn + DAXLIB references | "connect Power BI", "MCP", "DAX UDF", "DAXLIB" |
|
|
70
75
|
|
|
71
76
|
---
|
|
72
77
|
|
|
@@ -145,7 +150,7 @@ AI Assistant → microsoft-learn HTTP MCP → learn.microsoft.com docs
|
|
|
145
150
|
|
|
146
151
|
- Prefer user-level agent MCP config files written by `super install`. Use project-root `.mcp.json` only when the user explicitly uses an optional local Claude Code plugin.
|
|
147
152
|
- Never invent or hardcode local ports for the official Modeling MCP flow.
|
|
148
|
-
- On macOS/Linux,
|
|
153
|
+
- The current Desktop skills require Windows + Power BI Desktop. On macOS/Linux, do not offer partial local project workflows; explain the limitation and use `microsoft-learn` only for documentation. Future cloud/Fabric skills may support non-Windows workflows when they do not depend on Desktop.
|
|
149
154
|
|
|
150
155
|
---
|
|
151
156
|
|
package/src/content/routing.md
CHANGED
|
@@ -31,7 +31,7 @@ If config.isFirstSetup == true AND
|
|
|
31
31
|
config.hasRunProjectKickoff == false AND
|
|
32
32
|
config.skillPreferences.autoSuggestProjectKickoff == true:
|
|
33
33
|
|
|
34
|
-
→ Show welcome message and suggest /
|
|
34
|
+
→ Show welcome message and suggest /bi-kickoff
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
**Suggested message:**
|
|
@@ -39,7 +39,7 @@ If config.isFirstSetup == true AND
|
|
|
39
39
|
Welcome to BI Agent Superpowers! I noticed this is your first time here.
|
|
40
40
|
|
|
41
41
|
To get the most out of this toolkit, I recommend starting with
|
|
42
|
-
the **Project Kickoff** wizard (/
|
|
42
|
+
the **Project Kickoff** wizard (/bi-kickoff).
|
|
43
43
|
|
|
44
44
|
Would you like to start? (yes/no)
|
|
45
45
|
```
|
|
@@ -50,9 +50,9 @@ Scan current directory for relevant files:
|
|
|
50
50
|
|
|
51
51
|
| Files Detected | Suggested Skill |
|
|
52
52
|
|----------------|-----------------|
|
|
53
|
-
| `.pbix` / `.pbip` / `.tmdl` files | `/
|
|
54
|
-
| `.xlsx` / `.xlsm` files | `/
|
|
55
|
-
| Agent MCP config missing when user asks about Power BI | `/
|
|
53
|
+
| `.pbix` / `.pbip` / `.tmdl` files | `/bi-kickoff` (if not analyzed) |
|
|
54
|
+
| `.xlsx` / `.xlsm` files | `/bi-kickoff` |
|
|
55
|
+
| Agent MCP config missing when user asks about Power BI | `/bi-connect` |
|
|
56
56
|
|
|
57
57
|
### 4. CHECK KEYWORDS
|
|
58
58
|
|
|
@@ -61,9 +61,8 @@ Match user message against skill triggers:
|
|
|
61
61
|
| Keywords | Skill |
|
|
62
62
|
|----------|-------|
|
|
63
63
|
| "bi-start", "start session", "empezar", "what can you do here?" | `/bi-start` |
|
|
64
|
-
| "kickoff", "analyze project", "analizar proyecto", "qué tengo aquí?" | `/
|
|
65
|
-
| "connect Power BI", "MCP connection", "Power BI Desktop", "conectar Power BI", "modeling mcp" | `/
|
|
66
|
-
| "crear reportes", "armar reporte", "report design", "dashboard", "páginas del reporte", "visualizaciones" | `/report-design` |
|
|
64
|
+
| "kickoff", "analyze project", "analizar proyecto", "qué tengo aquí?" | `/bi-kickoff` |
|
|
65
|
+
| "connect Power BI", "MCP connection", "Power BI Desktop", "conectar Power BI", "modeling mcp", "DAX UDF", "functions.tmdl", "DAXLIB" | `/bi-connect` |
|
|
67
66
|
|
|
68
67
|
### 5. DEFAULT BEHAVIOR
|
|
69
68
|
|
|
@@ -99,8 +98,8 @@ Users can customize routing in `config.json`:
|
|
|
99
98
|
| Setting | Effect |
|
|
100
99
|
|---------|--------|
|
|
101
100
|
| `autoSuggestProjectKickoff: false` | Disable first-run auto-suggestion |
|
|
102
|
-
| `disabledSkills: ["
|
|
103
|
-
| `defaultSkill: "
|
|
101
|
+
| `disabledSkills: ["bi-connect"]` | Never suggest these skills |
|
|
102
|
+
| `defaultSkill: "bi-kickoff"` | Suggest this skill when context is ambiguous |
|
|
104
103
|
|
|
105
104
|
---
|
|
106
105
|
|
|
@@ -108,9 +107,9 @@ Users can customize routing in `config.json`:
|
|
|
108
107
|
|
|
109
108
|
| Skill | Purpose | Typical Duration |
|
|
110
109
|
|-------|---------|-----------------|
|
|
111
|
-
| `/
|
|
112
|
-
| `/
|
|
113
|
-
| `/
|
|
110
|
+
| `/bi-start` | Start a session, show the skill menu, check updates, and route to a specialist | 1-2 min |
|
|
111
|
+
| `/bi-kickoff` | Analyze a BI project, build the semantic model, and write AGENTS.md | 10-20 min |
|
|
112
|
+
| `/bi-connect` | Connect to Power BI Desktop via the official Microsoft MCP; guide DAX UDF authoring with Microsoft Learn + DAXLIB references | 2-10 min |
|
|
114
113
|
|
|
115
114
|
---
|
|
116
115
|
|
|
@@ -120,10 +119,8 @@ After completing a skill, suggest the logical next step:
|
|
|
120
119
|
|
|
121
120
|
| After Completing | Suggest Next |
|
|
122
121
|
|-----------------|--------------|
|
|
123
|
-
| `/
|
|
124
|
-
| `/
|
|
125
|
-
| `/report-design` | None — hand off to the user for refresh + iteration in Power BI Desktop |
|
|
126
|
-
| `/pbi-connect` | Back to `/project-kickoff` if the project hasn't been analyzed yet |
|
|
122
|
+
| `/bi-kickoff` (MCP not connected) | `/bi-connect` to set up the connection |
|
|
123
|
+
| `/bi-connect` | Back to `/bi-kickoff` if the project hasn't been analyzed yet |
|
|
127
124
|
|
|
128
125
|
**Suggestion format:**
|
|
129
126
|
```
|
|
@@ -137,7 +134,7 @@ Would you like to continue with that?
|
|
|
137
134
|
|
|
138
135
|
## Updating After Project Kickoff
|
|
139
136
|
|
|
140
|
-
After user completes `/
|
|
137
|
+
After user completes `/bi-kickoff`, update config:
|
|
141
138
|
|
|
142
139
|
```json
|
|
143
140
|
{
|