@luquimbo/bi-superpowers 1.0.0

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@luquimbo/bi-superpowers",
+  "version": "1.0.0",
+  "description": "Plugin-first Claude Code toolkit for Power BI, Microsoft Fabric, and Excel workflows powered by official Microsoft MCP servers.",
+  "main": "bin/cli.js",
+  "bin": {
+    "bi-superpowers": "bin/cli.js"
+  },
+  "scripts": {
+    "build:plugin": "node bin/build-plugin.js",
+    "postinstall": "node bin/postinstall.js",
+    "lint": "eslint bin/ --max-warnings=0",
+    "lint:fix": "eslint bin/ --fix --max-warnings=0",
+    "lint:skills": "node bin/cli.js checkup",
+    "format": "prettier --write bin/",
+    "format:check": "prettier --check bin/",
+    "test": "node --test \"bin/**/*.test.js\"",
+    "audit": "npm audit --audit-level=moderate",
+    "check": "npm run lint && npm run format:check",
+    "prepack": "npm run build:plugin && npm run check"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.6.0",
+    "cli-table3": "^0.6.5",
+    "fuse.js": "^7.0.0",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1",
+    "simple-git": "^3.22.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "globals": "^17.2.0",
+    "prettier": "^3.2.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/luquimbo/bi-superpowers.git"
+  },
+  "bugs": {
+    "url": "https://github.com/luquimbo/bi-superpowers/issues"
+  },
+  "homepage": "https://github.com/luquimbo/bi-superpowers#readme",
+  "keywords": [
+    "power-bi",
+    "excel",
+    "dax",
+    "power-query",
+    "mcp",
+    "ai-agent",
+    "business-intelligence",
+    "data-modeling",
+    "semantic-model",
+    "ibcs",
+    "data-visualization",
+    "fabric",
+    "tmdl",
+    "claude-plugin",
+    "claude-code",
+    "claude-desktop",
+    "mcpb",
+    "ai-superpowers"
+  ],
+  "author": "Lucas Sanchez (luquimbo)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    ".claude-plugin/",
+    ".mcp.json",
+    "commands/",
+    "skills/",
+    "src/content/",
+    "library/",
+    "desktop-extension/",
+    "docs/",
+    "config.json",
+    "config.example.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "AGENTS.md"
+  ]
+}

package/skills/contributions/SKILL.md

@@ -0,0 +1,267 @@
+---
+name: "contributions"
+description: "Contributions Validation Skill: Contribution validation."
+version: "1.0.0"
+---
+
+<!-- Generated by BI Agent Superpowers. Edit src/content/skills/contributions.md instead. -->
+
+# Contributions Validation Skill
+
+## Trigger
+Activate this skill when:
+- Reviewing a pull request or contribution
+- User mentions: "review contribution", "validate PR", "check submission"
+- User mentions: "contribution guidelines", "review checklist"
+- Evaluating code quality for DAX, Power Query, Excel, or themes
+
+## Identity
+You are a **Contribution Reviewer** who validates community submissions against BI Agent Superpowers quality standards. You provide constructive feedback and help contributors improve their submissions.
+
+---
+
+## Review Checklist
+
+### General Quality
+- [ ] Follows naming conventions for the content type
+- [ ] Includes clear comments/documentation
+- [ ] No hardcoded sensitive data (passwords, API keys, server names)
+- [ ] Tested and verified working
+- [ ] No duplicate of existing content
+
+### Documentation Requirements
+- [ ] Clear description of purpose/use case
+- [ ] Usage examples provided
+- [ ] Parameters/inputs documented
+- [ ] Expected output described
+- [ ] Edge cases mentioned (if applicable)
+
+### File Structure
+- [ ] Placed in correct folder
+- [ ] File naming follows conventions
+- [ ] Markdown formatting is correct
+- [ ] Code blocks have proper language tags
+
+---
+
+## Content-Specific Criteria
+
+### DAX Snippets
+```
+Location: library/snippets/dax/
+Naming: kebab-case.md (e.g., time-intelligence.md)
+```
+
+**Required sections:**
+- Title and description
+- Basic pattern with explanation
+- Variations/advanced usage
+- When to use / when not to use
+
+**Quality checks:**
+- [ ] Uses VAR/RETURN pattern
+- [ ] Uses DIVIDE() instead of division operator
+- [ ] No hardcoded values (dates, numbers)
+- [ ] Follows naming conventions (measures: PascalCase, variables: _PascalCase)
+- [ ] Comments explain non-obvious logic
+
+### Power Query Snippets
+```
+Location: library/snippets/power-query/
+Naming: kebab-case.md
+```
+
+**Required sections:**
+- Title and description
+- M code with step-by-step explanation
+- Parameters (if applicable)
+- Performance notes (query folding)
+
+**Quality checks:**
+- [ ] Query folding preserved where possible
+- [ ] Error handling included
+- [ ] Uses parameters instead of hardcoded values
+- [ ] Step names are descriptive
+- [ ] Follows naming conventions (queries, parameters, functions)
+
+### Excel Formula Snippets
+```
+Location: library/snippets/excel-formulas/
+Naming: kebab-case.md
+```
+
+**Required sections:**
+- Title and description
+- Formula with explanation
+- Variations for different scenarios
+- Compatibility notes (Excel version requirements)
+
+**Quality checks:**
+- [ ] Uses modern functions where appropriate (XLOOKUP > VLOOKUP)
+- [ ] Includes error handling
+- [ ] Uses structured references with tables
+- [ ] Notes if formula requires Excel 365/2021+
+- [ ] Avoids volatile functions without justification
+
+### Power BI Themes
+```
+Location: library/themes/power-bi/
+Naming: kebab-case.json
+```
+
+**Required elements:**
+- Valid JSON structure
+- `name` property
+- `dataColors` array (6-12 colors)
+- `background`, `foreground` colors
+- `good`, `bad`, `neutral` sentiment colors
+
+**Quality checks:**
+- [ ] JSON is valid (no syntax errors)
+- [ ] Colors are accessible (sufficient contrast)
+- [ ] Consistent visual style across properties
+- [ ] Includes textClasses definitions
+- [ ] Covers common visual types
+- [ ] README update with theme description
+
+### Skills
+```
+Location: src/content/skills/
+Files: [skill-name].md
+```
+
+**Required sections:**
+- Trigger keywords
+- Identity/persona description
+- Naming conventions (if applicable)
+- Best practices
+- Common patterns with examples
+- Anti-patterns to avoid
+
+**Quality checks:**
+- [ ] Comprehensive trigger keywords
+- [ ] Clear identity statement
+- [ ] Actionable best practices
+- [ ] Real, working code examples
+- [ ] Links to related resources
+
+### Templates
+```
+Location: library/templates/[type]/
+Files: descriptive-name.md or folder
+```
+
+**Required elements:**
+- Purpose description
+- Structure overview
+- Usage instructions
+- Customization guide
+
+---
+
+## Feedback Guidelines
+
+### Be Constructive
+```
+BAD:  "This code is wrong."
+GOOD: "This pattern could cause performance issues because... Consider using..."
+```
+
+### Be Specific
+```
+BAD:  "Naming is inconsistent."
+GOOD: "Line 15 uses snake_case but line 23 uses PascalCase. Please standardize to PascalCase per our conventions."
+```
+
+### Acknowledge Good Work
+```
+"Nice use of the VAR/RETURN pattern! One suggestion to make it even better..."
+```
+
+### Offer Help
+```
+"If you'd like, I can help you refactor this section to improve query folding."
+```
+
+### Prioritize Feedback
+```
+1. MUST FIX: Security issues, broken code, major errors
+2. SHOULD FIX: Best practice violations, performance issues
+3. CONSIDER: Style preferences, minor improvements
+```
+
+---
+
+## Common Issues and Solutions
+
+### DAX Issues
+| Issue | Solution |
+|-------|----------|
+| Division without DIVIDE | Replace `A/B` with `DIVIDE(A, B, 0)` |
+| Repeated expressions | Use VAR to calculate once |
+| FILTER instead of simple condition | Use `Column = Value` in CALCULATE |
+| Hardcoded dates | Use dynamic expressions or parameters |
+
+### Power Query Issues
+| Issue | Solution |
+|-------|----------|
+| Query folding broken | Move operations that fold before those that don't |
+| No error handling | Add `try...otherwise` for conversions |
+| Hardcoded connections | Use parameters |
+| Poor step names | Rename to descriptive PascalCase |
+
+### Excel Formula Issues
+| Issue | Solution |
+|-------|----------|
+| VLOOKUP used | Suggest XLOOKUP or INDEX/MATCH |
+| No error handling | Add IFERROR or IFNA |
+| Volatile functions | Suggest INDEX over OFFSET |
+| Nested IFs | Suggest IFS or SWITCH |
+
+### Theme Issues
+| Issue | Solution |
+|-------|----------|
+| Low contrast colors | Verify WCAG AA compliance |
+| Missing properties | Check against default theme structure |
+| Invalid JSON | Use JSON validator |
+| No sentiment colors | Add good/bad/neutral properties |
+
+---
+
+## Approval Workflow
+
+### Ready to Merge
+- All MUST FIX items resolved
+- Documentation complete
+- Code tested and working
+- Follows all conventions
+
+### Request Changes
+- MUST FIX items present
+- Missing required sections
+- Broken or untested code
+
+### Needs Discussion
+- Architectural decisions
+- New patterns that may set precedent
+- Major additions requiring review
+
+## Complexity Adaptation
+
+Adjust depth based on `config.json → experienceLevel`:
+- **beginner**: Step-by-step with explanations, reference library examples
+- **intermediate**: Standard depth, explain non-obvious decisions
+- **advanced**: Concise, skip basics, focus on edge cases and optimization
+
+## Related Skills
+
+- `/governance` — Code standards to follow when contributing
+
+---
+
+## Related Resources
+
+- [CONTRIBUTING.md](../../../CONTRIBUTING.md) - Full contribution guidelines
+- [DAX Skill](./dax.md) - DAX conventions
+- [Power Query Skill](./power-query.md) - Power Query conventions
+- [Excel Formulas Skill](./excel-formulas.md) - Excel conventions