@luquimbo/bi-superpowers 1.0.0

package/README.md

@@ -0,0 +1,211 @@
+# BI Agent Superpowers
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+[![Power BI](https://img.shields.io/badge/Power%20BI-Ready-F2C811?logo=powerbi)](https://powerbi.microsoft.com)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin--first-191919)](https://code.claude.com/docs/en/plugins)
+
+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.
+
+## Works with
+
+| Platform | How |
+|----------|-----|
+| **Claude Code** | Native plugin (`--plugin-dir .`) |
+| **1code.dev** | Uses Claude Code SDK — plugins work automatically |
+| **Claude Desktop** | MCPB extension (`super build-desktop`) |
+
+## Quick Start
+
+### Claude Code / 1code.dev
+
+```bash
+# Install globally
+npm install -g @luquimbo/bi-superpowers
+
+# Activate your license
+super unlock
+
+# Initialize in your project
+cd your-bi-project
+super kickoff
+
+# Run with the plugin
+claude --plugin-dir .
+```
+
+### Claude Desktop
+
+```bash
+super build-desktop
+# Double-click bi-superpowers.mcpb → installs in Claude Desktop
+# Skills available as MCP prompts
+```
+
+### Free models via OpenRouter (1code.dev)
+
+See [docs/openrouter-free-models.md](./docs/openrouter-free-models.md) for configuring free AI models with 1code.dev via OpenRouter.
+
+## Plugin Structure
+
+`super kickoff` generates the following in your project:
+
+```text
+.claude-plugin/plugin.json    # Plugin manifest
+.mcp.json                     # Power BI + Fabric MCPs
+commands/                     # 11 slash commands (interactive wizards)
+skills/                       # 24 skills (SKILL.md files)
+config.json                   # User preferences
+library/ → symlink            # Snippets, templates, themes
+```
+
+## Skills (24)
+
+### Command Skills (11 Interactive Wizards)
+
+| Skill | Purpose |
+|-------|---------|
+| `/project-kickoff` | Analyze and plan BI projects |
+| `/data-model-design` | Interactive star schema builder |
+| `/theme-tweaker` | Customize Power BI themes |
+| `/pbi-connect` | Connect to Power BI Desktop |
+| `/rls-design` | Row-level security design |
+| `/fabric-scripts` | Microsoft Fabric automation |
+| `/contributions` | Contribution guidelines |
+| `/dax-doctor` | DAX debugging and optimization |
+| `/model-documenter` | Semantic model documentation |
+| `/migration-assistant` | Migration and upgrade wizard |
+| `/report-layout` | Report page layout planner |
+
+### Reference Skills (13 Background Knowledge)
+
+| Skill | Purpose |
+|-------|---------|
+| `/dax` | DAX writing assistance |
+| `/power-query` | Power Query / M language |
+| `/data-modeling` | Star schema theory and patterns |
+| `/excel-formulas` | Modern Excel formulas |
+| `/fast-standard` | FP&A Financial modeling (FAST) |
+| `/query-performance` | Performance optimization |
+| `/data-quality` | Data profiling and validation |
+| `/testing-validation` | DAX and data testing workflows |
+| `/governance` | Naming conventions and standards |
+| `/semantic-model` | Semantic model best practices |
+| `/report-design` | Report design and visualization |
+| `/deployment` | CI/CD and deployment patterns |
+| `/dax-udf` | DAX user-defined functions (UDFs) |
+
+## Official MCP Stack
+
+BI Agent Superpowers centers on these Microsoft-supported MCP integrations:
+
+| MCP | Transport | Default config |
+| --- | --- | --- |
+| `powerbi-remote` | HTTP | `https://api.fabric.microsoft.com/v1/mcp/powerbi` |
+| `fabric-mcp-server` | stdio via `npx` | `npx -y @microsoft/fabric-mcp@latest server start --mode all` |
+| `powerbi-modeling-mcp` | stdio via local launcher | `node bin/mcp/powerbi-modeling-launcher.js` |
+
+### Platform notes
+
+- `powerbi-modeling-mcp` depends on Microsoft's official local executable and is only available on Windows.
+- `powerbi-remote` and `fabric-mcp-server` remain usable on macOS and Linux.
+
+## CLI Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `super kickoff` | Generate the Claude Code plugin in your project |
+| `super recharge` | Regenerate the plugin after editing source skills |
+| `super build-desktop` | Build MCPB extension for Claude Desktop |
+| `super mcp-setup` | Configure MCP servers |
+| `super powers` | Show available skills, snippets, and themes |
+| `super unlock` | Activate your license key |
+| `super upgrade` | Update to the latest version |
+| `super help` | Show help menu |
+
+### Developer Commands
+
+| Command | Description |
+|---------|-------------|
+| `super xray <query>` | Search snippets and library content |
+| `super checkup [file]` | Validate skill files for proper structure |
+| `super scan` | Show changes between source and generated configs |
+| `super sentinel` | Watch for changes and auto-regenerate |
+
+## Repository Structure
+
+```
+bi-superpowers/
+├── library/                    # Reusable assets
+│   ├── snippets/               # Code patterns (DAX, Power Query, Excel)
+│   ├── templates/              # Project templates
+│   ├── themes/                 # Power BI JSON themes
+│   └── examples/               # Reference implementations
+│
+├── src/content/                # Source content (build input)
+│   ├── base.md                 # Core AI identity
+│   ├── skills/                 # 24 skill definitions
+│   └── routing.md              # Skill activation logic
+│
+├── desktop-extension/          # Claude Desktop MCPB template
+│   ├── manifest.json           # MCPB v0.3 manifest
+│   ├── server.js               # MCP server exposing skills as prompts
+│   └── package.json            # Dependencies
+│
+├── docs/                       # Additional documentation
+│   └── openrouter-free-models.md
+│
+├── bin/                        # CLI tool
+├── config.json                 # AI preferences template
+└── AGENTS.md                   # AI documentation
+```
+
+## Project Type Comparison
+
+| Feature | Desktop (.pbix) | PBIP | Fabric |
+|---------|-----------------|------|--------|
+| Single file | Yes | No | N/A (cloud) |
+| Git-friendly | No | Yes | Yes |
+| Code reviews | No | Yes | Yes |
+| Works offline | Yes | Yes | No |
+| Team collaboration | Limited | Excellent | Excellent |
+| AI file access | Via running PBI | Direct file access | Via API |
+| License required | Free | Free | PPU or Fabric |
+| CI/CD ready | No | Yes | Yes |
+
+## Development
+
+```bash
+npm install
+npm run build:plugin
+npm test
+npm run check
+```
+
+## Resources
+
+- [Claude Code plugins docs](https://code.claude.com/docs/en/plugins)
+- [Claude Code MCP docs](https://code.claude.com/docs/en/mcp)
+- [Power BI MCP overview](https://learn.microsoft.com/en-us/power-bi/developer/mcp/mcp-servers-overview)
+- [Microsoft Fabric MCP Server](https://github.com/microsoft/mcp/tree/main/servers/Fabric.Mcp.Server)
+- [DAX Guide](https://dax.guide)
+
+## About the Author
+
+**Lucas Sánchez** — BI Consultant with **10+ years of experience** delivering Power BI, Excel, and data analytics projects for companies across industries.
+
+Creator of **[acadevor.com](https://acadevor.com)**, the leading Spanish-speaking community for Business Intelligence professionals.
+
+- LinkedIn: [linkedin.com/in/luquimbo](https://www.linkedin.com/in/luquimbo/)
+- GitHub: [github.com/luquimbo](https://github.com/luquimbo)
+- Community: [Acadevor.com](https://acadevor.com)
+
+## License
+
+[MIT](./LICENSE) — Free to use in personal and commercial projects.
+
+---
+
+**BI Agent Superpowers** — An AI-powered toolkit for Business Intelligence.

package/bin/build-plugin.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+/**
+ * Build the repository-root Claude Code plugin artifacts.
+ */
+
+const path = require('path');
+const pluginGenerator = require('./lib/generators/claude-plugin');
+const { loadSkills } = require('./lib/skills');
+const pkg = require('../package.json');
+
+async function main() {
+  const packageDir = path.dirname(__dirname);
+  const skills = loadSkills({
+    packageDir,
+    preferLocal: true,
+  });
+
+  await pluginGenerator.generate(packageDir, skills, {
+    packageDir,
+    version: pkg.version,
+    usePluginRootLauncher: true,
+    libraryPrefix: 'library',
+  });
+}
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exit(1);
+});