@luquimbo/bi-superpowers 1.0.0 → 1.1.2
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 +46 -0
- package/.claude-plugin/plugin.json +1 -1
- package/.mcp.json +4 -0
- package/AGENTS.md +98 -7
- package/README.md +139 -118
- package/bin/cli.js +45 -31
- package/bin/commands/install.js +317 -0
- package/bin/lib/microsoft-mcp.js +8 -0
- package/bin/lib/microsoft-mcp.test.js +5 -0
- package/package.json +1 -1
- package/skills/contributions/SKILL.md +1 -1
- package/skills/data-model-design/SKILL.md +1 -1
- package/skills/data-modeling/SKILL.md +82 -56
- package/skills/data-quality/SKILL.md +1 -1
- package/skills/dax/SKILL.md +74 -36
- package/skills/dax-doctor/SKILL.md +1 -1
- package/skills/dax-udf/SKILL.md +1 -1
- package/skills/deployment/SKILL.md +1 -1
- package/skills/excel-formulas/SKILL.md +1 -1
- package/skills/fabric-scripts/SKILL.md +1 -1
- package/skills/fast-standard/SKILL.md +1 -1
- package/skills/governance/SKILL.md +103 -50
- package/skills/migration-assistant/SKILL.md +1 -1
- package/skills/model-documenter/SKILL.md +1 -1
- package/skills/pbi-connect/SKILL.md +1 -1
- package/skills/power-query/SKILL.md +1 -1
- package/skills/project-kickoff/SKILL.md +1 -1
- package/skills/query-performance/SKILL.md +1 -1
- package/skills/report-design/SKILL.md +1 -1
- package/skills/report-layout/SKILL.md +1 -1
- package/skills/rls-design/SKILL.md +1 -1
- package/skills/semantic-model/SKILL.md +1 -1
- package/skills/testing-validation/SKILL.md +1 -1
- package/skills/theme-tweaker/SKILL.md +1 -1
- package/src/content/mcp-requirements.json +13 -0
- package/src/content/skills/data-modeling.md +81 -55
- package/src/content/skills/dax.md +73 -35
- package/src/content/skills/governance.md +102 -49
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "bi-superpowers",
|
|
3
|
+
"owner": {
|
|
4
|
+
"name": "Lucas Sanchez",
|
|
5
|
+
"url": "https://github.com/luquimbo"
|
|
6
|
+
},
|
|
7
|
+
"metadata": {
|
|
8
|
+
"description": "AI-powered skills for Power BI, Microsoft Fabric, and Excel development. 24 skills covering DAX, Power Query, data modeling, report design, governance, and more.",
|
|
9
|
+
"version": "1.0.1",
|
|
10
|
+
"repository": "https://github.com/luquimbo/bi-superpowers"
|
|
11
|
+
},
|
|
12
|
+
"plugins": [
|
|
13
|
+
{
|
|
14
|
+
"name": "bi-superpowers",
|
|
15
|
+
"description": "24 AI skills for Power BI, Fabric & Excel — DAX, Power Query, data modeling, star schema design, report design, governance, deployment, and more.",
|
|
16
|
+
"source": "./",
|
|
17
|
+
"strict": false,
|
|
18
|
+
"skills": [
|
|
19
|
+
"./skills/contributions",
|
|
20
|
+
"./skills/data-model-design",
|
|
21
|
+
"./skills/data-modeling",
|
|
22
|
+
"./skills/data-quality",
|
|
23
|
+
"./skills/dax",
|
|
24
|
+
"./skills/dax-doctor",
|
|
25
|
+
"./skills/dax-udf",
|
|
26
|
+
"./skills/deployment",
|
|
27
|
+
"./skills/excel-formulas",
|
|
28
|
+
"./skills/fabric-scripts",
|
|
29
|
+
"./skills/fast-standard",
|
|
30
|
+
"./skills/governance",
|
|
31
|
+
"./skills/migration-assistant",
|
|
32
|
+
"./skills/model-documenter",
|
|
33
|
+
"./skills/pbi-connect",
|
|
34
|
+
"./skills/power-query",
|
|
35
|
+
"./skills/project-kickoff",
|
|
36
|
+
"./skills/query-performance",
|
|
37
|
+
"./skills/report-design",
|
|
38
|
+
"./skills/report-layout",
|
|
39
|
+
"./skills/rls-design",
|
|
40
|
+
"./skills/semantic-model",
|
|
41
|
+
"./skills/testing-validation",
|
|
42
|
+
"./skills/theme-tweaker"
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
]
|
|
46
|
+
}
|
package/.mcp.json
CHANGED
package/AGENTS.md
CHANGED
|
@@ -15,29 +15,120 @@
|
|
|
15
15
|
- `library/`
|
|
16
16
|
- `config.json`
|
|
17
17
|
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Publishing to npm (for AI agents)
|
|
21
|
+
|
|
22
|
+
When the user asks for things like **"publica una nueva versión"**, **"publish a patch"**, **"sube esto a npm"**, **"release v1.2.0"**, follow this flow.
|
|
23
|
+
|
|
24
|
+
### How publishing works
|
|
25
|
+
|
|
26
|
+
The repo uses **GitHub Actions** to publish automatically. The `NPM_TOKEN` is stored as a GitHub Secret — never commit it to the repo or use it locally for publishes. The workflow at `.github/workflows/publish.yml` triggers on:
|
|
27
|
+
|
|
28
|
+
1. **Tag push** (`v*`) — preferred, triggered by pushing a version tag
|
|
29
|
+
2. **GitHub release published** — manual via web UI
|
|
30
|
+
3. **Manual workflow dispatch** — via Actions tab
|
|
31
|
+
|
|
32
|
+
### Standard publish flow (do this when asked)
|
|
33
|
+
|
|
34
|
+
1. **Verify clean working tree.** Run `git status` and ensure no uncommitted changes.
|
|
35
|
+
2. **Verify on `main` branch.** If on a feature branch, ask the user if you should merge first.
|
|
36
|
+
3. **Choose the version bump:**
|
|
37
|
+
- `patch` — bug fixes, doc updates, regenerated artifacts
|
|
38
|
+
- `minor` — new features, new skills, new commands (backwards compatible)
|
|
39
|
+
- `major` — breaking changes
|
|
40
|
+
4. **Run the bump:**
|
|
41
|
+
```bash
|
|
42
|
+
npm version patch --no-git-tag-version # or minor / major
|
|
43
|
+
```
|
|
44
|
+
5. **Run the local validations** (these also run in CI, but fail fast locally):
|
|
45
|
+
```bash
|
|
46
|
+
npm run build:plugin
|
|
47
|
+
npm run lint
|
|
48
|
+
npm run format:check
|
|
49
|
+
```
|
|
50
|
+
6. **Commit with conventional commit message:**
|
|
51
|
+
```bash
|
|
52
|
+
git add package.json package-lock.json [+ any regenerated files]
|
|
53
|
+
git commit -m "chore: bump version to X.Y.Z"
|
|
54
|
+
```
|
|
55
|
+
7. **Create the version tag:**
|
|
56
|
+
```bash
|
|
57
|
+
git tag vX.Y.Z
|
|
58
|
+
```
|
|
59
|
+
8. **Push commits and tag together:**
|
|
60
|
+
```bash
|
|
61
|
+
git push origin main --follow-tags
|
|
62
|
+
```
|
|
63
|
+
9. **Verify the publish triggered.** Tell the user to check https://github.com/luquimbo/bi-superpowers/actions — within 1-2 minutes the workflow runs and publishes.
|
|
64
|
+
10. **Confirm on npm.** Once the workflow finishes, run `npm view @luquimbo/bi-superpowers version` to confirm the new version is live.
|
|
65
|
+
|
|
66
|
+
### Critical rules
|
|
67
|
+
|
|
68
|
+
- **Never run `npm publish` locally.** The token lives in GitHub Secrets, not on developer machines. Local publishes bypass CI checks and history.
|
|
69
|
+
- **Never commit the npm token.** It belongs in `.env` (gitignored) for emergencies, or GitHub Secrets for CI.
|
|
70
|
+
- **Always tag versions with `v` prefix** (e.g., `v1.2.3`, not `1.2.3`). The workflow trigger expects `v*`.
|
|
71
|
+
- **Check for `prepack` regenerations.** The `prepack` script regenerates `skills/*/SKILL.md` and `.claude-plugin/plugin.json` with the new version. If running `npm version` triggers regeneration, commit those files in the same commit.
|
|
72
|
+
- **Don't bump version on feature branches.** Always bump on `main` after merge.
|
|
73
|
+
|
|
74
|
+
### When something goes wrong
|
|
75
|
+
|
|
76
|
+
- **Workflow fails because version already exists on npm:** the user already published manually. Bump again.
|
|
77
|
+
- **Workflow fails on lint/format:** run `npm run lint:fix && npm run format` locally, commit, retag, push.
|
|
78
|
+
- **Token expired or revoked:** ask the user to regenerate at https://www.npmjs.com/settings/luquimbo/tokens and update the GitHub Secret at https://github.com/luquimbo/bi-superpowers/settings/secrets/actions
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
18
82
|
AI-powered toolkit for Power BI, Fabric & Excel development.
|
|
19
83
|
|
|
20
84
|
Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
|
|
21
85
|
|
|
22
86
|
---
|
|
23
87
|
|
|
24
|
-
##
|
|
88
|
+
## Installation
|
|
89
|
+
|
|
90
|
+
### Option 1: Skills CLI (recommended — works everywhere)
|
|
25
91
|
|
|
26
92
|
```bash
|
|
27
|
-
|
|
28
|
-
|
|
93
|
+
npx skills add luquimbo/bi-superpowers
|
|
94
|
+
```
|
|
29
95
|
|
|
30
|
-
|
|
31
|
-
|
|
96
|
+
Installs all 24 skills into `.agents/skills/`. Works with **Claude Code, GitHub Copilot, Codex, Cursor**, and any agent supporting the Agent Skills specification.
|
|
97
|
+
|
|
98
|
+
### Option 2: Claude Code Plugin
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
/plugin marketplace add luquimbo/bi-superpowers
|
|
102
|
+
/plugin install bi-superpowers
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Option 3: Full CLI (premium — includes MCP, library, themes)
|
|
32
106
|
|
|
33
|
-
|
|
107
|
+
```bash
|
|
108
|
+
npm install -g @luquimbo/bi-superpowers
|
|
109
|
+
super unlock
|
|
34
110
|
super kickoff
|
|
35
111
|
```
|
|
36
112
|
|
|
37
|
-
|
|
113
|
+
### Option 4: Clone and copy
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
git clone https://github.com/luquimbo/bi-superpowers.git
|
|
117
|
+
cp -r bi-superpowers/skills/ .agents/skills/
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Option 5: Git submodule
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
git submodule add https://github.com/luquimbo/bi-superpowers.git .bi-superpowers
|
|
124
|
+
ln -s .bi-superpowers/skills skills
|
|
125
|
+
```
|
|
38
126
|
|
|
39
127
|
Works with:
|
|
40
128
|
- **Claude Code** — Native plugin (skills + commands + MCP)
|
|
129
|
+
- **GitHub Copilot** — Agent skills + plugin (VS Code & CLI)
|
|
130
|
+
- **Codex (OpenAI)** — Agent skills + plugin
|
|
131
|
+
- **Cursor / Windsurf** — Agent skills
|
|
41
132
|
- **1code.dev** — Uses Claude Code SDK (full plugin support)
|
|
42
133
|
- **Claude Desktop** — Via MCPB extension (`super build-desktop`)
|
|
43
134
|
|
package/README.md
CHANGED
|
@@ -1,24 +1,25 @@
|
|
|
1
1
|
# BI Agent Superpowers
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@luquimbo/bi-superpowers)
|
|
3
4
|
[](https://opensource.org/licenses/MIT)
|
|
4
5
|
[](https://nodejs.org)
|
|
5
6
|
[](https://powerbi.microsoft.com)
|
|
6
|
-
[](https://docs.anthropic.com/en/docs/claude-code)
|
|
7
8
|
|
|
8
9
|
AI-powered toolkit for Power BI, Microsoft Fabric & Excel development. Ships as a native Claude Code plugin with 24 skills, 11 interactive commands, and MCP integration with official Microsoft servers.
|
|
9
10
|
|
|
11
|
+
**Cross-platform**: Windows + macOS (Power BI Desktop and Excel MCP require Windows).
|
|
12
|
+
|
|
10
13
|
## Works with
|
|
11
14
|
|
|
12
|
-
| Platform | How |
|
|
13
|
-
|
|
14
|
-
| **Claude Code** | Native plugin (`--plugin-dir .`) |
|
|
15
|
-
| **1code.dev** | Uses Claude Code SDK — plugins work automatically |
|
|
16
|
-
| **Claude Desktop** | MCPB extension (`super build-desktop`) |
|
|
15
|
+
| Platform | How | Status |
|
|
16
|
+
|----------|-----|--------|
|
|
17
|
+
| **Claude Code** | Native plugin (`--plugin-dir .`) | Full support |
|
|
18
|
+
| **[1code.dev](https://1code.dev)** | Uses Claude Code SDK — plugins work automatically | Full support |
|
|
19
|
+
| **Claude Desktop** | MCPB extension (`super build-desktop`) | Skills as MCP prompts |
|
|
17
20
|
|
|
18
21
|
## Quick Start
|
|
19
22
|
|
|
20
|
-
### Claude Code / 1code.dev
|
|
21
|
-
|
|
22
23
|
```bash
|
|
23
24
|
# Install globally
|
|
24
25
|
npm install -g @luquimbo/bi-superpowers
|
|
@@ -38,131 +39,132 @@ claude --plugin-dir .
|
|
|
38
39
|
|
|
39
40
|
```bash
|
|
40
41
|
super build-desktop
|
|
41
|
-
# Double-click bi-superpowers.mcpb
|
|
42
|
-
#
|
|
42
|
+
# Double-click bi-superpowers.mcpb to install in Claude Desktop
|
|
43
|
+
# 24 skills available as MCP prompts
|
|
43
44
|
```
|
|
44
45
|
|
|
45
|
-
### Free models via OpenRouter
|
|
46
|
+
### Free models via OpenRouter
|
|
46
47
|
|
|
47
|
-
See [docs/openrouter-free-models.md](./docs/openrouter-free-models.md) for
|
|
48
|
+
Using [1code.dev](https://1code.dev) with free AI models? See [docs/openrouter-free-models.md](./docs/openrouter-free-models.md) for setup instructions.
|
|
48
49
|
|
|
49
50
|
## Plugin Structure
|
|
50
51
|
|
|
51
52
|
`super kickoff` generates the following in your project:
|
|
52
53
|
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
.
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
54
|
+
```
|
|
55
|
+
your-project/
|
|
56
|
+
├── .claude-plugin/plugin.json # Plugin manifest
|
|
57
|
+
├── .mcp.json # Power BI + Fabric MCPs
|
|
58
|
+
├── commands/ # 11 slash commands (interactive wizards)
|
|
59
|
+
├── skills/ # 24 skills (SKILL.md files)
|
|
60
|
+
├── config.json # User preferences (experience level, language, domain)
|
|
61
|
+
└── library/ → symlink # Snippets, templates, themes
|
|
60
62
|
```
|
|
61
63
|
|
|
62
64
|
## Skills (24)
|
|
63
65
|
|
|
64
|
-
### Command Skills
|
|
65
|
-
|
|
66
|
-
| Skill | Purpose |
|
|
67
|
-
|
|
68
|
-
| `/project-kickoff` | Analyze and plan BI projects |
|
|
69
|
-
| `/data-model-design` | Interactive star schema builder |
|
|
70
|
-
| `/
|
|
71
|
-
| `/
|
|
72
|
-
| `/
|
|
73
|
-
| `/
|
|
74
|
-
| `/
|
|
75
|
-
| `/
|
|
76
|
-
| `/
|
|
77
|
-
| `/
|
|
78
|
-
| `/
|
|
79
|
-
|
|
80
|
-
### Reference Skills
|
|
81
|
-
|
|
82
|
-
| Skill | Purpose |
|
|
83
|
-
|
|
84
|
-
| `/dax` | DAX writing
|
|
85
|
-
| `/power-query` | Power Query / M language |
|
|
86
|
-
| `/data-modeling` | Star schema theory and patterns |
|
|
87
|
-
| `/excel-formulas` | Modern Excel formulas |
|
|
88
|
-
| `/fast-standard` | FP&A
|
|
89
|
-
| `/query-performance` | Performance optimization |
|
|
90
|
-
| `/data-quality` | Data profiling and validation |
|
|
91
|
-
| `/testing-validation` | DAX and data testing workflows |
|
|
92
|
-
| `/governance` | Naming conventions and standards |
|
|
93
|
-
| `/semantic-model` | Semantic model best practices |
|
|
94
|
-
| `/report-design` | Report design and visualization |
|
|
95
|
-
| `/deployment` | CI/CD and deployment patterns |
|
|
96
|
-
| `/dax-udf` | DAX user-defined functions
|
|
97
|
-
|
|
98
|
-
##
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
| MCP | Transport |
|
|
103
|
-
|
|
104
|
-
| `powerbi-remote` | HTTP |
|
|
105
|
-
| `fabric-mcp-server` | stdio
|
|
106
|
-
| `powerbi-modeling-mcp` | stdio
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
- `powerbi-modeling-mcp` depends on Microsoft's official local executable and is only available on Windows.
|
|
111
|
-
- `powerbi-remote` and `fabric-mcp-server` remain usable on macOS and Linux.
|
|
66
|
+
### Command Skills — 11 Interactive Wizards
|
|
67
|
+
|
|
68
|
+
| Skill | Purpose | Trigger |
|
|
69
|
+
|-------|---------|---------|
|
|
70
|
+
| `/project-kickoff` | Analyze and plan BI projects | "new project", "analyze" |
|
|
71
|
+
| `/data-model-design` | Interactive star schema builder | "design model" |
|
|
72
|
+
| `/dax-doctor` | DAX debugging and optimization | "debug DAX", "fix measure" |
|
|
73
|
+
| `/theme-tweaker` | Customize Power BI themes | "customize theme", "colors" |
|
|
74
|
+
| `/pbi-connect` | Connect to Power BI Desktop | "connect Power BI" |
|
|
75
|
+
| `/rls-design` | Row-level security design | "RLS", "security" |
|
|
76
|
+
| `/fabric-scripts` | Microsoft Fabric automation | "Fabric scripts" |
|
|
77
|
+
| `/model-documenter` | Semantic model documentation | "document model" |
|
|
78
|
+
| `/migration-assistant` | Migration and upgrade wizard | "migrate", "move to Fabric" |
|
|
79
|
+
| `/report-layout` | Report page layout planner | "report layout" |
|
|
80
|
+
| `/contributions` | Contribution guidelines | "contribute", "PR" |
|
|
81
|
+
|
|
82
|
+
### Reference Skills — 13 Background Knowledge
|
|
83
|
+
|
|
84
|
+
| Skill | Purpose | Trigger |
|
|
85
|
+
|-------|---------|---------|
|
|
86
|
+
| `/dax` | DAX writing best practices | "DAX", "measure" |
|
|
87
|
+
| `/power-query` | Power Query / M language | "Power Query", "M code" |
|
|
88
|
+
| `/data-modeling` | Star schema theory and patterns | "star schema" |
|
|
89
|
+
| `/excel-formulas` | Modern Excel formulas | "XLOOKUP", "Excel formula" |
|
|
90
|
+
| `/fast-standard` | FP&A financial modeling (FAST) | "FAST standard" |
|
|
91
|
+
| `/query-performance` | Performance optimization | "optimize", "slow" |
|
|
92
|
+
| `/data-quality` | Data profiling and validation | "data quality" |
|
|
93
|
+
| `/testing-validation` | DAX and data testing workflows | "testing", "test cases" |
|
|
94
|
+
| `/governance` | Naming conventions and standards | "naming convention" |
|
|
95
|
+
| `/semantic-model` | Semantic model best practices | "TMDL", "DirectLake" |
|
|
96
|
+
| `/report-design` | Report design and visualization | "chart type", "IBCS" |
|
|
97
|
+
| `/deployment` | CI/CD and deployment patterns | "CI/CD", "pipeline" |
|
|
98
|
+
| `/dax-udf` | DAX user-defined functions | "UDF", "DEFINE FUNCTION" |
|
|
99
|
+
|
|
100
|
+
## MCP Integration
|
|
101
|
+
|
|
102
|
+
4 official Microsoft MCP servers configured automatically via `.mcp.json`:
|
|
103
|
+
|
|
104
|
+
| MCP Server | Transport | Platform | Description |
|
|
105
|
+
|------------|-----------|----------|-------------|
|
|
106
|
+
| `powerbi-remote` | HTTP | Windows, macOS, Linux | Power BI remote operations via Fabric API |
|
|
107
|
+
| `fabric-mcp-server` | stdio (`npx`) | Windows, macOS, Linux | Microsoft Fabric automation |
|
|
108
|
+
| `powerbi-modeling-mcp` | stdio (local) | Windows only | Local Power BI Desktop modeling |
|
|
109
|
+
| `microsoft-learn` | HTTP | Windows, macOS, Linux | Search Microsoft docs, code samples |
|
|
110
|
+
|
|
111
|
+
> **Note**: `powerbi-modeling-mcp` requires Power BI Desktop (Windows only). `microsoft-learn` is free, requires no authentication, and provides access to the full Microsoft Learn documentation library.
|
|
112
112
|
|
|
113
113
|
## CLI Commands
|
|
114
114
|
|
|
115
|
-
### Core Commands
|
|
116
|
-
|
|
117
115
|
| Command | Description |
|
|
118
116
|
|---------|-------------|
|
|
119
117
|
| `super kickoff` | Generate the Claude Code plugin in your project |
|
|
120
|
-
| `super recharge` | Regenerate
|
|
118
|
+
| `super recharge` | Regenerate plugin after editing source skills |
|
|
121
119
|
| `super build-desktop` | Build MCPB extension for Claude Desktop |
|
|
122
120
|
| `super mcp-setup` | Configure MCP servers |
|
|
123
121
|
| `super powers` | Show available skills, snippets, and themes |
|
|
124
122
|
| `super unlock` | Activate your license key |
|
|
125
123
|
| `super upgrade` | Update to the latest version |
|
|
126
|
-
| `super help` | Show help menu |
|
|
127
|
-
|
|
128
|
-
### Developer Commands
|
|
129
|
-
|
|
130
|
-
| Command | Description |
|
|
131
|
-
|---------|-------------|
|
|
132
124
|
| `super xray <query>` | Search snippets and library content |
|
|
133
|
-
| `super checkup [file]` | Validate skill files
|
|
134
|
-
| `super scan` | Show
|
|
125
|
+
| `super checkup [file]` | Validate skill files |
|
|
126
|
+
| `super scan` | Show diff between source and generated configs |
|
|
135
127
|
| `super sentinel` | Watch for changes and auto-regenerate |
|
|
128
|
+
| `super help` | Show help menu |
|
|
136
129
|
|
|
137
|
-
##
|
|
130
|
+
## Library
|
|
131
|
+
|
|
132
|
+
The `library/` folder contains reusable assets accessible from your prompts:
|
|
138
133
|
|
|
139
134
|
```
|
|
140
|
-
|
|
141
|
-
├──
|
|
142
|
-
│ ├──
|
|
143
|
-
│ ├──
|
|
144
|
-
│ ├──
|
|
145
|
-
│
|
|
146
|
-
│
|
|
147
|
-
├──
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
├──
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
135
|
+
library/
|
|
136
|
+
├── snippets/ # Code patterns
|
|
137
|
+
│ ├── dax/ # Time intelligence, CALCULATE, rankings, UDFs
|
|
138
|
+
│ ├── power-query/ # Transformations, error handling, API integration
|
|
139
|
+
│ ├── excel-formulas/ # Dynamic arrays, lookups, text functions
|
|
140
|
+
│ ├── report-design/ # Chart selection, accessibility, layouts
|
|
141
|
+
│ └── governance/ # Naming conventions, review checklists
|
|
142
|
+
├── templates/ # Project starters (Power BI, Excel, data models)
|
|
143
|
+
├── themes/ # Power BI JSON themes (6 themes included)
|
|
144
|
+
└── examples/ # Reference implementations
|
|
145
|
+
├── finance-reporting/
|
|
146
|
+
├── hr-analytics/
|
|
147
|
+
├── retail-analytics/
|
|
148
|
+
├── supply-chain/
|
|
149
|
+
└── marketing-analytics/
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Use in prompts: *"Using patterns from library/snippets/dax/time-intelligence.md, create a rolling 12-month average measure"*
|
|
153
|
+
|
|
154
|
+
## Configuration
|
|
155
|
+
|
|
156
|
+
`config.json` provides context to the AI about your experience level and domain:
|
|
157
|
+
|
|
158
|
+
```json
|
|
159
|
+
{
|
|
160
|
+
"experienceLevel": "intermediate",
|
|
161
|
+
"language": "en",
|
|
162
|
+
"workArea": "finance",
|
|
163
|
+
"powerBIConnection": "desktop"
|
|
164
|
+
}
|
|
163
165
|
```
|
|
164
166
|
|
|
165
|
-
## Project
|
|
167
|
+
## Project Types
|
|
166
168
|
|
|
167
169
|
| Feature | Desktop (.pbix) | PBIP | Fabric |
|
|
168
170
|
|---------|-----------------|------|--------|
|
|
@@ -172,40 +174,59 @@ bi-superpowers/
|
|
|
172
174
|
| Works offline | Yes | Yes | No |
|
|
173
175
|
| Team collaboration | Limited | Excellent | Excellent |
|
|
174
176
|
| AI file access | Via running PBI | Direct file access | Via API |
|
|
175
|
-
| License required | Free | Free | PPU or Fabric |
|
|
176
177
|
| CI/CD ready | No | Yes | Yes |
|
|
177
178
|
|
|
179
|
+
## Repository Structure
|
|
180
|
+
|
|
181
|
+
```
|
|
182
|
+
bi-superpowers/
|
|
183
|
+
├── bin/ # CLI tool and commands
|
|
184
|
+
├── src/content/ # Source content (single source of truth)
|
|
185
|
+
│ ├── base.md # Core AI identity
|
|
186
|
+
│ ├── routing.md # Skill activation logic
|
|
187
|
+
│ └── skills/ # 24 skill definitions
|
|
188
|
+
├── library/ # Reusable assets (snippets, templates, themes)
|
|
189
|
+
├── desktop-extension/ # Claude Desktop MCPB template
|
|
190
|
+
├── docs/ # Additional documentation
|
|
191
|
+
├── commands/ # Generated slash commands
|
|
192
|
+
├── skills/ # Generated SKILL.md files
|
|
193
|
+
├── .claude-plugin/ # Plugin manifest
|
|
194
|
+
├── .mcp.json # MCP server configuration
|
|
195
|
+
├── config.json # AI preferences
|
|
196
|
+
└── AGENTS.md # AI context and documentation
|
|
197
|
+
```
|
|
198
|
+
|
|
178
199
|
## Development
|
|
179
200
|
|
|
180
201
|
```bash
|
|
181
202
|
npm install
|
|
182
|
-
npm run build:plugin
|
|
183
|
-
npm test
|
|
184
|
-
npm run check
|
|
203
|
+
npm run build:plugin # Generate 11 commands + 24 skills
|
|
204
|
+
npm test # 77 tests
|
|
205
|
+
npm run check # ESLint + Prettier
|
|
185
206
|
```
|
|
186
207
|
|
|
187
208
|
## Resources
|
|
188
209
|
|
|
189
|
-
- [Claude Code plugins
|
|
190
|
-
- [Claude Code MCP docs](https://code.claude.com/docs/en/mcp)
|
|
210
|
+
- [Claude Code plugins](https://docs.anthropic.com/en/docs/claude-code)
|
|
191
211
|
- [Power BI MCP overview](https://learn.microsoft.com/en-us/power-bi/developer/mcp/mcp-servers-overview)
|
|
192
|
-
- [Microsoft Fabric MCP
|
|
212
|
+
- [Microsoft Fabric MCP](https://github.com/microsoft/mcp/tree/main/servers/Fabric.Mcp.Server)
|
|
193
213
|
- [DAX Guide](https://dax.guide)
|
|
214
|
+
- [OpenRouter free models](./docs/openrouter-free-models.md)
|
|
194
215
|
|
|
195
|
-
##
|
|
216
|
+
## Author
|
|
196
217
|
|
|
197
|
-
**Lucas Sánchez** — BI Consultant with
|
|
218
|
+
**Lucas Sánchez** — BI Consultant with 10+ years delivering Power BI, Excel, and data analytics projects.
|
|
198
219
|
|
|
199
|
-
Creator of **[
|
|
220
|
+
Creator of **[Acadevor.com](https://acadevor.com)**, the leading Spanish-speaking community for Business Intelligence professionals.
|
|
200
221
|
|
|
201
|
-
- LinkedIn
|
|
202
|
-
- GitHub
|
|
203
|
-
-
|
|
222
|
+
- [LinkedIn](https://www.linkedin.com/in/luquimbo/)
|
|
223
|
+
- [GitHub](https://github.com/luquimbo)
|
|
224
|
+
- [Acadevor](https://acadevor.com)
|
|
204
225
|
|
|
205
226
|
## License
|
|
206
227
|
|
|
207
|
-
[MIT](./LICENSE)
|
|
228
|
+
[MIT](./LICENSE)
|
|
208
229
|
|
|
209
230
|
---
|
|
210
231
|
|
|
211
|
-
**BI Agent Superpowers** —
|
|
232
|
+
**BI Agent Superpowers** v1.0.0 — AI-powered toolkit for Business Intelligence.
|