@luquimbo/bi-superpowers 1.0.0 → 1.1.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.
Files changed (38) hide show
  1. package/.claude-plugin/marketplace.json +46 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.mcp.json +4 -0
  4. package/AGENTS.md +34 -7
  5. package/README.md +139 -118
  6. package/bin/cli.js +45 -31
  7. package/bin/commands/install.js +321 -0
  8. package/bin/lib/microsoft-mcp.js +8 -0
  9. package/bin/lib/microsoft-mcp.test.js +5 -0
  10. package/package.json +1 -1
  11. package/skills/contributions/SKILL.md +1 -1
  12. package/skills/data-model-design/SKILL.md +1 -1
  13. package/skills/data-modeling/SKILL.md +82 -56
  14. package/skills/data-quality/SKILL.md +1 -1
  15. package/skills/dax/SKILL.md +74 -36
  16. package/skills/dax-doctor/SKILL.md +1 -1
  17. package/skills/dax-udf/SKILL.md +1 -1
  18. package/skills/deployment/SKILL.md +1 -1
  19. package/skills/excel-formulas/SKILL.md +1 -1
  20. package/skills/fabric-scripts/SKILL.md +1 -1
  21. package/skills/fast-standard/SKILL.md +1 -1
  22. package/skills/governance/SKILL.md +103 -50
  23. package/skills/migration-assistant/SKILL.md +1 -1
  24. package/skills/model-documenter/SKILL.md +1 -1
  25. package/skills/pbi-connect/SKILL.md +1 -1
  26. package/skills/power-query/SKILL.md +1 -1
  27. package/skills/project-kickoff/SKILL.md +1 -1
  28. package/skills/query-performance/SKILL.md +1 -1
  29. package/skills/report-design/SKILL.md +1 -1
  30. package/skills/report-layout/SKILL.md +1 -1
  31. package/skills/rls-design/SKILL.md +1 -1
  32. package/skills/semantic-model/SKILL.md +1 -1
  33. package/skills/testing-validation/SKILL.md +1 -1
  34. package/skills/theme-tweaker/SKILL.md +1 -1
  35. package/src/content/mcp-requirements.json +13 -0
  36. package/src/content/skills/data-modeling.md +81 -55
  37. package/src/content/skills/dax.md +73 -35
  38. 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
+ }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "bi-superpowers",
3
3
  "description": "Claude Code plugin for Power BI, Microsoft Fabric, and semantic model workflows powered by the official Microsoft MCP servers.",
4
- "version": "1.0.0",
4
+ "version": "1.1.1",
5
5
  "author": {
6
6
  "name": "Lucas Sanchez"
7
7
  }
package/.mcp.json CHANGED
@@ -21,5 +21,9 @@
21
21
  "args": [
22
22
  "${CLAUDE_PLUGIN_ROOT}/bin/mcp/powerbi-modeling-launcher.js"
23
23
  ]
24
+ },
25
+ "microsoft-learn": {
26
+ "type": "http",
27
+ "url": "https://learn.microsoft.com/api/mcp"
24
28
  }
25
29
  }
package/AGENTS.md CHANGED
@@ -21,23 +21,50 @@ Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
21
21
 
22
22
  ---
23
23
 
24
- ## Quick Start
24
+ ## Installation
25
+
26
+ ### Option 1: Skills CLI (recommended — works everywhere)
25
27
 
26
28
  ```bash
27
- # Install globally
28
- npm install -g @luquimbo/bi-superpowers
29
+ npx skills add luquimbo/bi-superpowers
30
+ ```
29
31
 
30
- # Activate your license
31
- super unlock
32
+ Installs all 24 skills into `.agents/skills/`. Works with **Claude Code, GitHub Copilot, Codex, Cursor**, and any agent supporting the Agent Skills specification.
33
+
34
+ ### Option 2: Claude Code Plugin
32
35
 
33
- # Initialize in your project
36
+ ```bash
37
+ /plugin marketplace add luquimbo/bi-superpowers
38
+ /plugin install bi-superpowers
39
+ ```
40
+
41
+ ### Option 3: Full CLI (premium — includes MCP, library, themes)
42
+
43
+ ```bash
44
+ npm install -g @luquimbo/bi-superpowers
45
+ super unlock
34
46
  super kickoff
35
47
  ```
36
48
 
37
- The `bi-superpowers kickoff` command generates the Claude Code plugin in your project.
49
+ ### Option 4: Clone and copy
50
+
51
+ ```bash
52
+ git clone https://github.com/luquimbo/bi-superpowers.git
53
+ cp -r bi-superpowers/skills/ .agents/skills/
54
+ ```
55
+
56
+ ### Option 5: Git submodule
57
+
58
+ ```bash
59
+ git submodule add https://github.com/luquimbo/bi-superpowers.git .bi-superpowers
60
+ ln -s .bi-superpowers/skills skills
61
+ ```
38
62
 
39
63
  Works with:
40
64
  - **Claude Code** — Native plugin (skills + commands + MCP)
65
+ - **GitHub Copilot** — Agent skills + plugin (VS Code & CLI)
66
+ - **Codex (OpenAI)** — Agent skills + plugin
67
+ - **Cursor / Windsurf** — Agent skills
41
68
  - **1code.dev** — Uses Claude Code SDK (full plugin support)
42
69
  - **Claude Desktop** — Via MCPB extension (`super build-desktop`)
43
70
 
package/README.md CHANGED
@@ -1,24 +1,25 @@
1
1
  # BI Agent Superpowers
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/@luquimbo/bi-superpowers)](https://www.npmjs.com/package/@luquimbo/bi-superpowers)
3
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4
5
  [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
5
6
  [![Power BI](https://img.shields.io/badge/Power%20BI-Ready-F2C811?logo=powerbi)](https://powerbi.microsoft.com)
6
- [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin--first-191919)](https://code.claude.com/docs/en/plugins)
7
+ [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-191919)](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 installs in Claude Desktop
42
- # Skills available as MCP prompts
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 (1code.dev)
46
+ ### Free models via OpenRouter
46
47
 
47
- See [docs/openrouter-free-models.md](./docs/openrouter-free-models.md) for configuring free AI models with 1code.dev via OpenRouter.
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
- ```text
54
- .claude-plugin/plugin.json # Plugin manifest
55
- .mcp.json # Power BI + Fabric MCPs
56
- commands/ # 11 slash commands (interactive wizards)
57
- skills/ # 24 skills (SKILL.md files)
58
- config.json # User preferences
59
- library/ → symlink # Snippets, templates, themes
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 (11 Interactive Wizards)
65
-
66
- | Skill | Purpose |
67
- |-------|---------|
68
- | `/project-kickoff` | Analyze and plan BI projects |
69
- | `/data-model-design` | Interactive star schema builder |
70
- | `/theme-tweaker` | Customize Power BI themes |
71
- | `/pbi-connect` | Connect to Power BI Desktop |
72
- | `/rls-design` | Row-level security design |
73
- | `/fabric-scripts` | Microsoft Fabric automation |
74
- | `/contributions` | Contribution guidelines |
75
- | `/dax-doctor` | DAX debugging and optimization |
76
- | `/model-documenter` | Semantic model documentation |
77
- | `/migration-assistant` | Migration and upgrade wizard |
78
- | `/report-layout` | Report page layout planner |
79
-
80
- ### Reference Skills (13 Background Knowledge)
81
-
82
- | Skill | Purpose |
83
- |-------|---------|
84
- | `/dax` | DAX writing assistance |
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 Financial modeling (FAST) |
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 (UDFs) |
97
-
98
- ## Official MCP Stack
99
-
100
- BI Agent Superpowers centers on these Microsoft-supported MCP integrations:
101
-
102
- | MCP | Transport | Default config |
103
- | --- | --- | --- |
104
- | `powerbi-remote` | HTTP | `https://api.fabric.microsoft.com/v1/mcp/powerbi` |
105
- | `fabric-mcp-server` | stdio via `npx` | `npx -y @microsoft/fabric-mcp@latest server start --mode all` |
106
- | `powerbi-modeling-mcp` | stdio via local launcher | `node bin/mcp/powerbi-modeling-launcher.js` |
107
-
108
- ### Platform notes
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 the plugin after editing source skills |
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 for proper structure |
134
- | `super scan` | Show changes between source and generated configs |
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
- ## Repository Structure
130
+ ## Library
131
+
132
+ The `library/` folder contains reusable assets accessible from your prompts:
138
133
 
139
134
  ```
140
- bi-superpowers/
141
- ├── library/ # Reusable assets
142
- │ ├── snippets/ # Code patterns (DAX, Power Query, Excel)
143
- │ ├── templates/ # Project templates
144
- │ ├── themes/ # Power BI JSON themes
145
- └── examples/ # Reference implementations
146
-
147
- ├── src/content/ # Source content (build input)
148
- ├── base.md # Core AI identity
149
- │ ├── skills/ # 24 skill definitions
150
- │ └── routing.md # Skill activation logic
151
-
152
- ├── desktop-extension/ # Claude Desktop MCPB template
153
- ├── manifest.json # MCPB v0.3 manifest
154
- │ ├── server.js # MCP server exposing skills as prompts
155
- │ └── package.json # Dependencies
156
-
157
- ├── docs/ # Additional documentation
158
- │ └── openrouter-free-models.md
159
-
160
- ├── bin/ # CLI tool
161
- ├── config.json # AI preferences template
162
- └── AGENTS.md # AI documentation
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 Type Comparison
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 docs](https://code.claude.com/docs/en/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 Server](https://github.com/microsoft/mcp/tree/main/servers/Fabric.Mcp.Server)
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
- ## About the Author
216
+ ## Author
196
217
 
197
- **Lucas Sánchez** — BI Consultant with **10+ years of experience** delivering Power BI, Excel, and data analytics projects for companies across industries.
218
+ **Lucas Sánchez** — BI Consultant with 10+ years delivering Power BI, Excel, and data analytics projects.
198
219
 
199
- Creator of **[acadevor.com](https://acadevor.com)**, the leading Spanish-speaking community for Business Intelligence professionals.
220
+ Creator of **[Acadevor.com](https://acadevor.com)**, the leading Spanish-speaking community for Business Intelligence professionals.
200
221
 
201
- - LinkedIn: [linkedin.com/in/luquimbo](https://www.linkedin.com/in/luquimbo/)
202
- - GitHub: [github.com/luquimbo](https://github.com/luquimbo)
203
- - Community: [Acadevor.com](https://acadevor.com)
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) — Free to use in personal and commercial projects.
228
+ [MIT](./LICENSE)
208
229
 
209
230
  ---
210
231
 
211
- **BI Agent Superpowers** — An AI-powered toolkit for Business Intelligence.
232
+ **BI Agent Superpowers** v1.0.0 — AI-powered toolkit for Business Intelligence.
package/bin/cli.js CHANGED
@@ -43,7 +43,7 @@ try {
43
43
  // Wrapped in try-catch because they may not be available during initial npm install
44
44
  let searchCommand, lintCommand, diffCommand, watchCommand, mcpSetupCommand, tui;
45
45
  let setupCommand, addCommand, pullCommand, pushCommand, syncProfileCommand, syncSourceCommand;
46
- let changelogCommand, buildDesktopCommand;
46
+ let changelogCommand, buildDesktopCommand, installCommand;
47
47
  try {
48
48
  searchCommand = require('./commands/search'); // Fuzzy search across library content
49
49
  lintCommand = require('./commands/lint'); // Skill file validation
@@ -61,6 +61,7 @@ try {
61
61
  syncSourceCommand = require('./commands/sync-source'); // Bidirectional sync
62
62
  changelogCommand = require('./commands/changelog'); // Generate changelog from Git
63
63
  buildDesktopCommand = require('./commands/build-desktop'); // Build MCPB for Claude Desktop
64
+ installCommand = require('./commands/install'); // Multi-agent skill installer
64
65
  } catch (e) {
65
66
  // Silent fail - commands may not be available during npm install phase
66
67
  // This is expected behavior, not an error condition
@@ -126,47 +127,29 @@ const AI_TOOLS = generators ? generators.AI_TOOLS : {};
126
127
  * - Developer: Advanced tools for content management (xray, checkup, scan, sentinel, powers)
127
128
  * - Legacy: Old command names maintained for backward compatibility
128
129
  */
130
+ // Commands are registered lazily to avoid TDZ issues with const wrappers.
131
+ // Core commands use hoisted function declarations; developer commands use
132
+ // createCommandWrapper which is defined later. We populate the map in
133
+ // registerCommands() which runs before main().
129
134
  const commands = {
130
- // Core commands - basic info and status
135
+ // Core commands - basic info and status (hoisted functions, safe here)
131
136
  help: showHelp,
132
137
  version: showVersion,
133
138
  about: showInfo,
134
139
  status: showLicenseStatus,
135
140
 
136
- // Setup & sync - project configuration
137
- kickoff: initProject, // Interactive project setup wizard
138
- recharge: syncProject, // Regenerate AI tool configs from skills
139
- unlock: activateLicense, // Activate license key
140
- upgrade: updatePackage, // Update to latest npm version
141
-
142
- // Developer tools - content management
143
- xray: runSearch, // Fuzzy search library content
144
- checkup: runLint, // Validate skill files
145
- scan: runDiff, // Compare source vs generated
146
- sentinel: runWatch, // Watch and auto-regenerate
147
- powers: listAgents, // List available skills
148
- 'mcp-setup': runMcpSetup, // Configure MCP servers for AI tools
149
- mcp: runMcpSetup, // Alias for mcp-setup
150
- 'build-desktop': runBuildDesktop, // Build MCPB extension for Claude Desktop
141
+ // Setup & sync - project configuration (hoisted functions, safe here)
142
+ kickoff: initProject,
143
+ recharge: syncProject,
144
+ unlock: activateLicense,
145
+ upgrade: updatePackage,
146
+ powers: listAgents,
151
147
 
152
- // Repo multi-project commands (v3)
153
- setup: runSetup, // Onboarding wizard - creates bi-repo
154
- add: runAdd, // Add project to bi-repo
155
- pull: runPull, // Pull changes from original file to repo
156
- push: runPush, // Push changes from repo to original file
157
- 'sync-source': runSyncSource, // Bidirectional sync with original file
158
- 'sync-profile': runSyncProfile, // Sync snippets to base profile
159
- changelog: runChangelog, // Generate changelog from Git history
160
-
161
- // Legacy aliases (backward compatibility with v2.0.x)
148
+ // Legacy aliases (hoisted functions, safe here)
162
149
  init: initProject,
163
150
  sync: syncProject,
164
151
  activate: activateLicense,
165
152
  update: updatePackage,
166
- search: runSearch,
167
- lint: runLint,
168
- diff: runDiff,
169
- watch: runWatch,
170
153
  list: listAgents,
171
154
  info: showInfo,
172
155
  };
@@ -199,6 +182,7 @@ Usage:
199
182
  super <command> [options]
200
183
 
201
184
  Commands:
185
+ install Install skills for your AI agents (Claude, Copilot, Codex...)
202
186
  unlock Activate your license key
203
187
  kickoff [path] Initialize the Claude Code plugin in your project
204
188
  recharge [path] Regenerate the plugin from source skills
@@ -225,7 +209,15 @@ Repo Multi-Proyecto (v3):
225
209
  Options:
226
210
  --dry-run Preview changes without creating files (kickoff, recharge)
227
211
 
212
+ Install options:
213
+ --agent, -a Specify agents (e.g. -a claude-code -a codex)
214
+ --all Install for all supported agents
215
+ --yes, -y Skip confirmation prompts
216
+
228
217
  Examples:
218
+ super install # Interactive multi-agent installer
219
+ super install -a claude-code # Install for Claude Code only
220
+ super install --all --yes # Install for all agents, no prompts
229
221
  super unlock # Activate your license
230
222
  super kickoff # Initialize plugin in current directory
231
223
  super kickoff ./my-project # Initialize in specific directory
@@ -1006,6 +998,28 @@ const runSyncSource = createCommandWrapper(syncSourceCommand, 'Sync-source');
1006
998
  const runSyncProfile = createCommandWrapper(syncProfileCommand, 'Sync-profile');
1007
999
  const runChangelog = createCommandWrapper(changelogCommand, 'Changelog');
1008
1000
  const runBuildDesktop = createCommandWrapper(buildDesktopCommand, 'Build Desktop');
1001
+ const runInstall = createCommandWrapper(installCommand, 'Install');
1002
+
1003
+ // Register commands that depend on createCommandWrapper (avoids TDZ in object literal)
1004
+ commands.install = runInstall;
1005
+ commands.xray = runSearch;
1006
+ commands.checkup = runLint;
1007
+ commands.scan = runDiff;
1008
+ commands.sentinel = runWatch;
1009
+ commands['mcp-setup'] = runMcpSetup;
1010
+ commands.mcp = runMcpSetup;
1011
+ commands['build-desktop'] = runBuildDesktop;
1012
+ commands.setup = runSetup;
1013
+ commands.add = runAdd;
1014
+ commands.pull = runPull;
1015
+ commands.push = runPush;
1016
+ commands['sync-source'] = runSyncSource;
1017
+ commands['sync-profile'] = runSyncProfile;
1018
+ commands.changelog = runChangelog;
1019
+ commands.search = runSearch;
1020
+ commands.lint = runLint;
1021
+ commands.diff = runDiff;
1022
+ commands.watch = runWatch;
1009
1023
 
1010
1024
  /**
1011
1025
  * Run watch command (special case - needs additional context)