superkit-mcp-server 1.2.1 → 1.2.3

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 (170) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/security-auditor.md +3 -2
  18. package/agents/tester.md +274 -274
  19. package/agents/ui-designer.md +208 -208
  20. package/build/index.js +21 -2
  21. package/build/tools/__tests__/loggerTools.test.js +5 -5
  22. package/build/tools/archTools.js +2 -19
  23. package/build/tools/autoPreview.js +2 -2
  24. package/build/tools/compoundTools.js +4 -4
  25. package/build/tools/docsTools.js +5 -10
  26. package/build/tools/loggerTools.js +1 -1
  27. package/build/tools/todoTools.js +39 -39
  28. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  29. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  30. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  31. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  32. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  33. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  34. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  35. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  36. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  37. package/build/tools/validators/convertRules.js +2 -2
  38. package/commands/README.md +122 -122
  39. package/commands/ask.toml +72 -72
  40. package/commands/brainstorm.toml +119 -119
  41. package/commands/chat.toml +77 -77
  42. package/commands/code-preview.toml +37 -37
  43. package/commands/code.toml +28 -28
  44. package/commands/content.toml +200 -200
  45. package/commands/cook.toml +77 -77
  46. package/commands/copywrite.toml +131 -131
  47. package/commands/db.toml +192 -192
  48. package/commands/debug.toml +166 -166
  49. package/commands/design.toml +158 -158
  50. package/commands/dev-rules.toml +14 -14
  51. package/commands/do.toml +117 -117
  52. package/commands/doc-rules.toml +14 -14
  53. package/commands/docs.toml +148 -148
  54. package/commands/fix.toml +440 -440
  55. package/commands/fullstack.toml +175 -175
  56. package/commands/git.toml +235 -235
  57. package/commands/help.toml +84 -84
  58. package/commands/integrate.toml +127 -127
  59. package/commands/journal.toml +136 -136
  60. package/commands/kit-setup.toml +40 -40
  61. package/commands/mcp.toml +183 -183
  62. package/commands/orchestration.toml +15 -15
  63. package/commands/plan.toml +171 -171
  64. package/commands/pm.toml +148 -148
  65. package/commands/pr.toml +50 -50
  66. package/commands/project.toml +32 -32
  67. package/commands/research.toml +117 -117
  68. package/commands/review-pr.toml +63 -63
  69. package/commands/review.toml +190 -190
  70. package/commands/scout-ext.toml +97 -97
  71. package/commands/scout.toml +79 -79
  72. package/commands/screenshot.toml +65 -65
  73. package/commands/session.toml +102 -102
  74. package/commands/skill.toml +384 -384
  75. package/commands/status.toml +22 -22
  76. package/commands/team.toml +56 -56
  77. package/commands/test.toml +164 -164
  78. package/commands/ticket.toml +70 -70
  79. package/commands/use.toml +106 -106
  80. package/commands/video.toml +83 -83
  81. package/commands/watzup.toml +71 -71
  82. package/commands/workflow.toml +14 -14
  83. package/package.json +35 -35
  84. package/skills/meta/README.md +30 -30
  85. package/skills/meta/api-design/SKILL.md +134 -134
  86. package/skills/meta/code-review/SKILL.md +44 -44
  87. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  88. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  89. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  90. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  91. package/skills/meta/compound-docs/SKILL.md +133 -133
  92. package/skills/meta/debug/SKILL.md +40 -40
  93. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  94. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  95. package/skills/meta/docker/SKILL.md +126 -126
  96. package/skills/meta/examples/supabase/SKILL.md +46 -46
  97. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  98. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  99. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  100. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  101. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  102. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  103. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  104. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  105. package/skills/meta/file-todos/SKILL.md +88 -88
  106. package/skills/meta/mobile/SKILL.md +140 -140
  107. package/skills/meta/nextjs/SKILL.md +101 -101
  108. package/skills/meta/performance/SKILL.md +130 -130
  109. package/skills/meta/react-patterns/SKILL.md +83 -83
  110. package/skills/meta/security/SKILL.md +114 -114
  111. package/skills/meta/session-resume/SKILL.md +96 -96
  112. package/skills/meta/tailwind/SKILL.md +139 -139
  113. package/skills/meta/testing/SKILL.md +43 -43
  114. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  115. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  116. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  117. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  118. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  119. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  120. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  121. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  122. package/skills/tech/alpha-vantage/references/options.md +93 -93
  123. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  124. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  125. package/skills/tech/doc.md +6 -6
  126. package/skills/tech/financial-modeling/SKILL.md +18 -18
  127. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  128. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  129. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  130. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  131. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  132. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  133. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  134. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  135. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  136. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  137. package/skills/workflows/README.md +203 -203
  138. package/skills/workflows/adr.md +174 -174
  139. package/skills/workflows/changelog.md +74 -74
  140. package/skills/workflows/compound.md +323 -323
  141. package/skills/workflows/compound_health.md +74 -74
  142. package/skills/workflows/create-agent-skill.md +138 -139
  143. package/skills/workflows/cycle.md +144 -144
  144. package/skills/workflows/deploy-docs.md +84 -84
  145. package/skills/workflows/development-rules.md +42 -42
  146. package/skills/workflows/doc.md +95 -95
  147. package/skills/workflows/documentation-management.md +34 -34
  148. package/skills/workflows/explore.md +146 -146
  149. package/skills/workflows/generate_command.md +106 -106
  150. package/skills/workflows/heal-skill.md +97 -97
  151. package/skills/workflows/housekeeping.md +229 -229
  152. package/skills/workflows/kit-setup.md +102 -102
  153. package/skills/workflows/map-codebase.md +78 -78
  154. package/skills/workflows/orchestration-protocol.md +43 -43
  155. package/skills/workflows/plan-compound.md +439 -439
  156. package/skills/workflows/plan_review.md +269 -269
  157. package/skills/workflows/primary-workflow.md +37 -37
  158. package/skills/workflows/promote_pattern.md +86 -86
  159. package/skills/workflows/release-docs.md +82 -82
  160. package/skills/workflows/report-bug.md +135 -135
  161. package/skills/workflows/reproduce-bug.md +118 -118
  162. package/skills/workflows/resolve_pr.md +133 -133
  163. package/skills/workflows/resolve_todo.md +128 -128
  164. package/skills/workflows/review-compound.md +376 -376
  165. package/skills/workflows/skill-review.md +127 -127
  166. package/skills/workflows/specs.md +257 -257
  167. package/skills/workflows/triage-sprint.md +102 -102
  168. package/skills/workflows/triage.md +152 -152
  169. package/skills/workflows/work.md +399 -399
  170. package/skills/workflows/xcode-test.md +93 -93
package/commands/mcp.toml CHANGED
@@ -1,183 +1,183 @@
1
- description = "MCP tools management - browser, docs, scraping (MCP Manager Agent)"
2
-
3
- prompt = """
4
- # 🔌 MCP MANAGER AGENT
5
-
6
- MCP task:
7
-
8
- **Task:** {{args}}
9
-
10
- ## WHAT IS MCP?
11
- Model Context Protocol - external tools for:
12
- - Browser automation (screenshots, forms)
13
- - Docs lookup (library documentation)
14
- - Web scraping (data extraction)
15
- - DevTools Protocol access
16
-
17
- ---
18
-
19
- ## MODE DETECTION
20
-
21
- | Mode | Trigger | Action |
22
- |------|---------|--------|
23
- | **SCREENSHOT** | "screenshot", "visual" | Capture webpage |
24
- | **FORM** | "form", "fill", "submit" | Form automation |
25
- | **DOCS** | "docs", "lookup", "find" | Query library docs |
26
- | **SCRAPE** | "scrape", "extract", "data" | Web scraping |
27
- | **STATUS** | "status", "check", "monitor" | Health check |
28
-
29
- ---
30
-
31
- ## SCREENSHOT MODE - Visual Testing
32
-
33
- ### Compare Staging vs Prod
34
- ```bash
35
- # Capture screenshots
36
- mcp screenshot https://staging.app.com/dashboard --viewport 1920x1080
37
- mcp screenshot https://prod.app.com/dashboard --viewport 1920x1080
38
-
39
- # Compare
40
- mcp diff staging.png prod.png --highlight
41
- ```
42
-
43
- ### Viewport Options
44
- | Size | Value |
45
- |------|-------|
46
- | Desktop | `1920x1080` |
47
- | Tablet | `768x1024` |
48
- | Mobile | `375x667` |
49
-
50
- ---
51
-
52
- ## FORM MODE - Automation
53
-
54
- ### Fill and Submit
55
- ```javascript
56
- // Using Puppeteer/Playwright via MCP
57
- await page.goto('https://example.com/contact');
58
- await page.fill('#name', 'John Doe');
59
- await page.fill('#email', 'john@example.com');
60
- await page.fill('#message', 'Test message');
61
- await page.click('button[type="submit"]');
62
- await page.screenshot({ path: 'confirmation.png' });
63
- ```
64
-
65
- ### Chain Operations
66
- Navigate → Fill form → Submit → Screenshot confirmation
67
-
68
- ---
69
-
70
- ## DOCS MODE - Library Lookup
71
-
72
- ### Query Documentation
73
- ```bash
74
- # Supabase auth
75
- mcp docs supabase "OAuth providers MFA setup"
76
-
77
- # Next.js
78
- mcp docs nextjs "app router server components"
79
-
80
- # React
81
- mcp docs react "useEffect cleanup"
82
- ```
83
-
84
- ### Supported Libraries
85
- - Next.js
86
- - React
87
- - Supabase
88
- - Prisma
89
- - Tailwind
90
- - (via context7/docs servers)
91
-
92
- ---
93
-
94
- ## SCRAPE MODE - Data Extraction
95
-
96
- ### Extract Table Data
97
- ```javascript
98
- // Get all products
99
- const products = await page.evaluate(() => {
100
- return [...document.querySelectorAll('table tr')].map(row => ({
101
- name: row.querySelector('td:nth-child(1)')?.textContent,
102
- price: row.querySelector('td:nth-child(2)')?.textContent
103
- }));
104
- });
105
- ```
106
-
107
- ### Output Format
108
- ```json
109
- [
110
- {"name": "Product A", "price": "$99"},
111
- {"name": "Product B", "price": "$149"}
112
- ]
113
- ```
114
-
115
- ---
116
-
117
- ## STATUS MODE - Monitoring
118
-
119
- ### Health Check
120
- ```bash
121
- # Navigate and verify
122
- mcp navigate https://status.service.com
123
- mcp assert ".status-indicator" --text "All Systems Operational"
124
- mcp screenshot-if-red ".status-indicator.error"
125
- ```
126
-
127
- ---
128
-
129
- ## CONFIGURATION
130
-
131
- ### Gemini CLI MCP Settings
132
- Location: `~/.gemini/settings.json`
133
-
134
- ```json
135
- {
136
- "mcpServers": {
137
- "puppeteer": {
138
- "command": "npx",
139
- "args": ["-y", "@anthropic/mcp-server-puppeteer"]
140
- },
141
- "context7": {
142
- "command": "npx",
143
- "args": ["-y", "context7-mcp"],
144
- "env": {
145
- "CONTEXT7_API_KEY": "your-key"
146
- }
147
- }
148
- }
149
- }
150
- ```
151
-
152
- ---
153
-
154
- ## PRO TIPS
155
-
156
- 1. **Install Gemini CLI** - Required for MCP execution
157
- 2. **Chain operations** - Multi-step in one prompt
158
- 3. **Default viewport** - 1920x1080, specify for mobile
159
- 4. **Error handling** - Agent reports with fixes
160
- 5. **Screenshot defaults** - Full-page captures
161
-
162
- ---
163
-
164
- ## ERROR HANDLING
165
-
166
- | Error | Fix |
167
- |-------|-----|
168
- | Timeout | Check URL, increase timeout |
169
- | Connection | Verify settings.json config |
170
- | Element not found | Check selector, wait for load |
171
- | Auth required | Add cookies/headers |
172
-
173
- > **Key Takeaway:** Access 100+ MCP tools via natural language. Browser automation stays isolated from main context.
174
- """
175
-
176
- # ---
177
- # USAGE:
178
- # /mcp screenshot staging.app.com vs prod
179
- # /mcp fill contact form with test data
180
- # /mcp docs supabase OAuth setup
181
- # /mcp scrape product table from competitor.com
182
- # /mcp status check monitoring page
183
- # ---
1
+ description = "MCP tools management - browser, docs, scraping (MCP Manager Agent)"
2
+
3
+ prompt = """
4
+ # 🔌 MCP MANAGER AGENT
5
+
6
+ MCP task:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ## WHAT IS MCP?
11
+ Model Context Protocol - external tools for:
12
+ - Browser automation (screenshots, forms)
13
+ - Docs lookup (library documentation)
14
+ - Web scraping (data extraction)
15
+ - DevTools Protocol access
16
+
17
+ ---
18
+
19
+ ## MODE DETECTION
20
+
21
+ | Mode | Trigger | Action |
22
+ |------|---------|--------|
23
+ | **SCREENSHOT** | "screenshot", "visual" | Capture webpage |
24
+ | **FORM** | "form", "fill", "submit" | Form automation |
25
+ | **DOCS** | "docs", "lookup", "find" | Query library docs |
26
+ | **SCRAPE** | "scrape", "extract", "data" | Web scraping |
27
+ | **STATUS** | "status", "check", "monitor" | Health check |
28
+
29
+ ---
30
+
31
+ ## SCREENSHOT MODE - Visual Testing
32
+
33
+ ### Compare Staging vs Prod
34
+ ```bash
35
+ # Capture screenshots
36
+ mcp screenshot https://staging.app.com/dashboard --viewport 1920x1080
37
+ mcp screenshot https://prod.app.com/dashboard --viewport 1920x1080
38
+
39
+ # Compare
40
+ mcp diff staging.png prod.png --highlight
41
+ ```
42
+
43
+ ### Viewport Options
44
+ | Size | Value |
45
+ |------|-------|
46
+ | Desktop | `1920x1080` |
47
+ | Tablet | `768x1024` |
48
+ | Mobile | `375x667` |
49
+
50
+ ---
51
+
52
+ ## FORM MODE - Automation
53
+
54
+ ### Fill and Submit
55
+ ```javascript
56
+ // Using Puppeteer/Playwright via MCP
57
+ await page.goto('https://example.com/contact');
58
+ await page.fill('#name', 'John Doe');
59
+ await page.fill('#email', 'john@example.com');
60
+ await page.fill('#message', 'Test message');
61
+ await page.click('button[type="submit"]');
62
+ await page.screenshot({ path: 'confirmation.png' });
63
+ ```
64
+
65
+ ### Chain Operations
66
+ Navigate → Fill form → Submit → Screenshot confirmation
67
+
68
+ ---
69
+
70
+ ## DOCS MODE - Library Lookup
71
+
72
+ ### Query Documentation
73
+ ```bash
74
+ # Supabase auth
75
+ mcp docs supabase "OAuth providers MFA setup"
76
+
77
+ # Next.js
78
+ mcp docs nextjs "app router server components"
79
+
80
+ # React
81
+ mcp docs react "useEffect cleanup"
82
+ ```
83
+
84
+ ### Supported Libraries
85
+ - Next.js
86
+ - React
87
+ - Supabase
88
+ - Prisma
89
+ - Tailwind
90
+ - (via context7/docs servers)
91
+
92
+ ---
93
+
94
+ ## SCRAPE MODE - Data Extraction
95
+
96
+ ### Extract Table Data
97
+ ```javascript
98
+ // Get all products
99
+ const products = await page.evaluate(() => {
100
+ return [...document.querySelectorAll('table tr')].map(row => ({
101
+ name: row.querySelector('td:nth-child(1)')?.textContent,
102
+ price: row.querySelector('td:nth-child(2)')?.textContent
103
+ }));
104
+ });
105
+ ```
106
+
107
+ ### Output Format
108
+ ```json
109
+ [
110
+ {"name": "Product A", "price": "$99"},
111
+ {"name": "Product B", "price": "$149"}
112
+ ]
113
+ ```
114
+
115
+ ---
116
+
117
+ ## STATUS MODE - Monitoring
118
+
119
+ ### Health Check
120
+ ```bash
121
+ # Navigate and verify
122
+ mcp navigate https://status.service.com
123
+ mcp assert ".status-indicator" --text "All Systems Operational"
124
+ mcp screenshot-if-red ".status-indicator.error"
125
+ ```
126
+
127
+ ---
128
+
129
+ ## CONFIGURATION
130
+
131
+ ### Gemini CLI MCP Settings
132
+ Location: `~/.gemini/settings.json`
133
+
134
+ ```json
135
+ {
136
+ "mcpServers": {
137
+ "puppeteer": {
138
+ "command": "npx",
139
+ "args": ["-y", "@anthropic/mcp-server-puppeteer"]
140
+ },
141
+ "context7": {
142
+ "command": "npx",
143
+ "args": ["-y", "context7-mcp"],
144
+ "env": {
145
+ "CONTEXT7_API_KEY": "your-key"
146
+ }
147
+ }
148
+ }
149
+ }
150
+ ```
151
+
152
+ ---
153
+
154
+ ## PRO TIPS
155
+
156
+ 1. **Install Gemini CLI** - Required for MCP execution
157
+ 2. **Chain operations** - Multi-step in one prompt
158
+ 3. **Default viewport** - 1920x1080, specify for mobile
159
+ 4. **Error handling** - Agent reports with fixes
160
+ 5. **Screenshot defaults** - Full-page captures
161
+
162
+ ---
163
+
164
+ ## ERROR HANDLING
165
+
166
+ | Error | Fix |
167
+ |-------|-----|
168
+ | Timeout | Check URL, increase timeout |
169
+ | Connection | Verify settings.json config |
170
+ | Element not found | Check selector, wait for load |
171
+ | Auth required | Add cookies/headers |
172
+
173
+ > **Key Takeaway:** Access 100+ MCP tools via natural language. Browser automation stays isolated from main context.
174
+ """
175
+
176
+ # ---
177
+ # USAGE:
178
+ # /mcp screenshot staging.app.com vs prod
179
+ # /mcp fill contact form with test data
180
+ # /mcp docs supabase OAuth setup
181
+ # /mcp scrape product table from competitor.com
182
+ # /mcp status check monitoring page
183
+ # ---
@@ -1,15 +1,15 @@
1
- description = "View agent orchestration protocols"
2
-
3
- prompt = """
4
- You are an Orchestration Expert. Read and explain the orchestration protocols.
5
-
6
- @{.agent/workflows/orchestration-protocol.md}
7
-
8
- Based on the protocols above, help the user with: {{args}}
9
-
10
- If no specific question, explain:
11
- 1. Sequential vs Parallel orchestration
12
- 2. Hybrid patterns
13
- 3. MCP tools for coordination
14
- 4. Best practices
15
- """
1
+ description = "View agent orchestration protocols"
2
+
3
+ prompt = """
4
+ You are an Orchestration Expert. Read and explain the orchestration protocols.
5
+
6
+ @{skills/workflows/orchestration-protocol.md}
7
+
8
+ Based on the protocols above, help the user with: {{args}}
9
+
10
+ If no specific question, explain:
11
+ 1. Sequential vs Parallel orchestration
12
+ 2. Hybrid patterns
13
+ 3. MCP tools for coordination
14
+ 4. Best practices
15
+ """