superkit-mcp-server 1.2.2 → 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 +18 -9
  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
@@ -1,74 +1,74 @@
1
- ---
2
- description: Check the improved Compound System's health and usage metrics.
3
- ---
4
-
5
- # /compound_health - System Health Check
6
-
7
- Use this workflow weekly to ensure the Compound System is actually working.
8
-
9
- ## Workflow
10
-
11
- ### Step 0: Search & Log
12
-
13
- ```bash
14
- // turbo
15
- Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/compound_health", outcome: "success" }
16
- Call MCP `call_tool_compound_manager` { action: "search", terms: [ "system health"] }
17
- ```
18
-
19
- ### Step 1: Run Health Dashboard
20
-
21
- ```bash
22
- Call MCP `call_tool_compound_manager` { action: "health" }
23
- ```
24
-
25
- ### Step 2: Analyze Metrics
26
-
27
- **Coverage:**
28
- - **Target:** >50%
29
- - **Action if Low:** Commit to running `/compound-search` before every `/plan`.
30
-
31
- **Usage:**
32
- - **Target:** >3 invocations/week
33
- - **Action if Low:** Remind yourself to use the scripts!
34
-
35
- **Staleness:**
36
- - **Action:** Any solution not referenced in >6 months -> Review for deprecation.
37
-
38
- ### Step 3: Maintenance
39
-
40
- 1. **Fix Orphans**: Run `./scripts/update-solution-ref.sh` on solutions you know you've used recently.
41
- 2. **Promote Patterns**: If new pattern candidates are identified, run `/compound`.
42
-
43
- ### Step 4: Record Status
44
-
45
- Add an entry to `docs/solutions/changelog.md` (or equivalent) noting the health stats.
46
-
47
- ### Phase 5: Completion & Handoff
48
-
49
- #### Step 1: Establish Terminal UI State
50
-
51
- ```javascript
52
- await task_boundary({
53
- TaskName: "[COMPLETED] System Health Check",
54
- TaskStatus: "Health checked and recorded. Offering next steps.",
55
- Mode: "VERIFICATION",
56
- TaskSummary: "Completed system health check. Grade: {grade}, Coverage: {coverage}%."
57
- });
58
- ```
59
-
60
- #### Step 2: Mandatory Handoff
61
-
62
- ```bash
63
- ✓ Health check complete
64
-
65
- Next steps:
66
- 1. /housekeeping - Fix any issues found
67
- 2. /plan - Plan improvements to lower technical debt
68
- ```
69
-
70
- ---
71
-
72
- ## References
73
-
74
- - [Health Script](Call MCP `call_tool_compound_manager` { action: "health" })
1
+ ---
2
+ description: Check the improved Compound System's health and usage metrics.
3
+ ---
4
+
5
+ # /compound_health - System Health Check
6
+
7
+ Use this workflow weekly to ensure the Compound System is actually working.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 0: Search & Log
12
+
13
+ ```bash
14
+ // turbo
15
+ Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/compound_health", outcome: "success" }
16
+ Call MCP `call_tool_compound_manager` { action: "search", terms: [ "system health"] }
17
+ ```
18
+
19
+ ### Step 1: Run Health Dashboard
20
+
21
+ ```bash
22
+ Call MCP `call_tool_compound_manager` { action: "health" }
23
+ ```
24
+
25
+ ### Step 2: Analyze Metrics
26
+
27
+ **Coverage:**
28
+ - **Target:** >50%
29
+ - **Action if Low:** Commit to running `/compound-search` before every `/plan`.
30
+
31
+ **Usage:**
32
+ - **Target:** >3 invocations/week
33
+ - **Action if Low:** Remind yourself to use the scripts!
34
+
35
+ **Staleness:**
36
+ - **Action:** Any solution not referenced in >6 months -> Review for deprecation.
37
+
38
+ ### Step 3: Maintenance
39
+
40
+ 1. **Fix Orphans**: Run `Call MCP call_tool_compound_manager { action: "updateRef" }` on solutions you know you've used recently.
41
+ 2. **Promote Patterns**: If new pattern candidates are identified, run `/compound`.
42
+
43
+ ### Step 4: Record Status
44
+
45
+ Add an entry to `docs/solutions/changelog.md` (or equivalent) noting the health stats.
46
+
47
+ ### Phase 5: Completion & Handoff
48
+
49
+ #### Step 1: Establish Terminal UI State
50
+
51
+ ```javascript
52
+ await task_boundary({
53
+ TaskName: "[COMPLETED] System Health Check",
54
+ TaskStatus: "Health checked and recorded. Offering next steps.",
55
+ Mode: "VERIFICATION",
56
+ TaskSummary: "Completed system health check. Grade: {grade}, Coverage: {coverage}%."
57
+ });
58
+ ```
59
+
60
+ #### Step 2: Mandatory Handoff
61
+
62
+ ```bash
63
+ ✓ Health check complete
64
+
65
+ Next steps:
66
+ 1. /housekeeping - Fix any issues found
67
+ 2. /plan - Plan improvements to lower technical debt
68
+ ```
69
+
70
+ ---
71
+
72
+ ## References
73
+
74
+ - [Health Script](Call MCP `call_tool_compound_manager` { action: "health" })
@@ -1,139 +1,138 @@
1
- ---
2
- description: Create new skills for extending agent capabilities. Use to add new domain expertise.
3
- ---
4
-
5
- # /create-agent-skill - Build New Skills
6
-
7
- Create modular skills that extend agent capabilities.
8
-
9
- ## Skill Architecture
10
-
11
- Skills are filesystem-based capabilities:
12
-
13
- ```
14
- skills/{skill-name}/
15
- ├── SKILL.md # Router + essential principles (always loaded)
16
- ├── workflows/ # Step-by-step procedures
17
- ├── references/ # Domain knowledge
18
- ├── templates/ # Output structures
19
- └── scripts/ # Reusable code
20
- ```
21
-
22
- ## Workflow
23
-
24
- ### Step 0: Check for Existing Skills/Logic
25
-
26
- Verify that a similar skill doesn't already exist or that existing scripts can't be reused to achieve the goal.
27
-
28
- ```bash
29
- // turbo
30
- Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/create-agent-skill", outcome: "success" }
31
- Call MCP `call_tool_compound_manager` { action: "search", terms: [ "new skill creation"] }
32
-
33
- ls skills/
34
- grep -r "{skill keywords}" skills/
35
- ```
36
-
37
- ---
38
-
39
- ### Step 1: Define Skill Purpose
40
-
41
- ```
42
- Skill name: {name}
43
- Domain: {area of expertise}
44
- Core capability: {what it enables}
45
- ```
46
-
47
- ### Step 2: Create Directory Structure
48
-
49
- ```bash
50
- mkdir -p skills/{skill-name}/{workflows,references,templates,scripts}
51
- ```
52
-
53
- ### Step 3: Create SKILL.md (Router)
54
-
55
- ```markdown
56
- ---
57
- name: {skill-name}
58
- description: {what this skill provides}
59
- ---
60
-
61
- # {Skill Name}
62
-
63
- ## Overview
64
-
65
- {Brief description of capability}
66
-
67
- - {Condition 2}
68
-
69
- ## Instrumentation
70
-
71
- ```bash
72
- # Log usage when using this skill
73
- Call MCP `call_tool_logger_manager` { action: "logSkill", name: "{skill-name}", outcome: "manual" }
74
- ```
75
-
76
- ## What do you want to do?
77
-
78
- 1. **{Action 1}** → Read `workflows/action1.md`
79
- 2. **{Action 2}** → Read `workflows/action2.md`
80
- 3. **{Action 3}** → Read `references/knowledge.md`
81
- ```
82
-
83
- ### Step 4: Add Workflows
84
-
85
- Create step-by-step procedures in `workflows/`:
86
-
87
- ```markdown
88
- # {Workflow Name}
89
-
90
- ## Prerequisites
91
- - {Required setup}
92
-
93
- ## Steps
94
- 1. {Step 1}
95
- 2. {Step 2}
96
- 3. {Step 3}
97
-
98
- ## Expected Output
99
- {What success looks like}
100
- ```
101
-
102
- ### Step 5: Add References
103
-
104
- Add domain knowledge in `references/`:
105
- - Best practices
106
- - Common patterns
107
- - Examples
108
-
109
- ### Phase 5: Completion & Handoff
110
-
111
- #### Step 1: Establish Terminal UI State
112
-
113
- ```javascript
114
- await task_boundary({
115
- TaskName: "[COMPLETED] New Skill: {Skill Name}",
116
- TaskStatus: "Skill created and instrumented. Offering next steps.",
117
- Mode: "VERIFICATION",
118
- TaskSummary: "Created new skill {name} with structure: SKILL.md, workflows/, references/."
119
- });
120
- ```
121
-
122
- #### Step 2: Mandatory Handoff
123
-
124
- ```bash
125
- ✓ Skill created: skills/{name}/
126
-
127
- Next steps:
128
- 1. /work - Implement workflows for the new skill
129
- 2. /compound - Document the new capability
130
- ```
131
-
132
- ---
133
-
134
- ## Principles
135
-
136
- 1. **Skills are prompts** - All prompting best practices apply
137
- 2. **SKILL.md is always loaded** - Keep essential principles inline
138
- 3. **Router pattern** - Ask what to do, then route
139
- 4. **Progressive disclosure** - Load only what's needed
1
+ ---
2
+ description: Create new skills for extending agent capabilities. Use to add new domain expertise.
3
+ ---
4
+
5
+ # /create-agent-skill - Build New Skills
6
+
7
+ Create modular skills that extend agent capabilities.
8
+
9
+ ## Skill Architecture
10
+
11
+ Skills are filesystem-based capabilities:
12
+
13
+ ```
14
+ skills/{skill-name}/
15
+ ├── SKILL.md # Router + essential principles (always loaded)
16
+ ├── workflows/ # Step-by-step procedures
17
+ ├── references/ # Domain knowledge
18
+ └── templates/ # Output structures
19
+ ```
20
+
21
+ ## Workflow
22
+
23
+ ### Step 0: Check for Existing Skills/Logic
24
+
25
+ Verify that a similar skill doesn't already exist or that existing scripts can't be reused to achieve the goal.
26
+
27
+ ```bash
28
+ // turbo
29
+ Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/create-agent-skill", outcome: "success" }
30
+ Call MCP `call_tool_compound_manager` { action: "search", terms: [ "new skill creation"] }
31
+
32
+ ls skills/
33
+ grep -r "{skill keywords}" skills/
34
+ ```
35
+
36
+ ---
37
+
38
+ ### Step 1: Define Skill Purpose
39
+
40
+ ```
41
+ Skill name: {name}
42
+ Domain: {area of expertise}
43
+ Core capability: {what it enables}
44
+ ```
45
+
46
+ ### Step 2: Create Directory Structure
47
+
48
+ ```bash
49
+ mkdir -p skills/{skill-name}/{workflows,references,templates,scripts}
50
+ ```
51
+
52
+ ### Step 3: Create SKILL.md (Router)
53
+
54
+ ```markdown
55
+ ---
56
+ name: {skill-name}
57
+ description: {what this skill provides}
58
+ ---
59
+
60
+ # {Skill Name}
61
+
62
+ ## Overview
63
+
64
+ {Brief description of capability}
65
+
66
+ - {Condition 2}
67
+
68
+ ## Instrumentation
69
+
70
+ ```bash
71
+ # Log usage when using this skill
72
+ Call MCP `call_tool_logger_manager` { action: "logSkill", name: "{skill-name}", outcome: "manual" }
73
+ ```
74
+
75
+ ## What do you want to do?
76
+
77
+ 1. **{Action 1}** → Read `workflows/action1.md`
78
+ 2. **{Action 2}** → Read `workflows/action2.md`
79
+ 3. **{Action 3}** → Read `references/knowledge.md`
80
+ ```
81
+
82
+ ### Step 4: Add Workflows
83
+
84
+ Create step-by-step procedures in `workflows/`:
85
+
86
+ ```markdown
87
+ # {Workflow Name}
88
+
89
+ ## Prerequisites
90
+ - {Required setup}
91
+
92
+ ## Steps
93
+ 1. {Step 1}
94
+ 2. {Step 2}
95
+ 3. {Step 3}
96
+
97
+ ## Expected Output
98
+ {What success looks like}
99
+ ```
100
+
101
+ ### Step 5: Add References
102
+
103
+ Add domain knowledge in `references/`:
104
+ - Best practices
105
+ - Common patterns
106
+ - Examples
107
+
108
+ ### Phase 5: Completion & Handoff
109
+
110
+ #### Step 1: Establish Terminal UI State
111
+
112
+ ```javascript
113
+ await task_boundary({
114
+ TaskName: "[COMPLETED] New Skill: {Skill Name}",
115
+ TaskStatus: "Skill created and instrumented. Offering next steps.",
116
+ Mode: "VERIFICATION",
117
+ TaskSummary: "Created new skill {name} with structure: SKILL.md, workflows/, references/."
118
+ });
119
+ ```
120
+
121
+ #### Step 2: Mandatory Handoff
122
+
123
+ ```bash
124
+ ✓ Skill created: skills/{name}/
125
+
126
+ Next steps:
127
+ 1. /work - Implement workflows for the new skill
128
+ 2. /compound - Document the new capability
129
+ ```
130
+
131
+ ---
132
+
133
+ ## Principles
134
+
135
+ 1. **Skills are prompts** - All prompting best practices apply
136
+ 2. **SKILL.md is always loaded** - Keep essential principles inline
137
+ 3. **Router pattern** - Ask what to do, then route
138
+ 4. **Progressive disclosure** - Load only what's needed