superkit-mcp-server 1.2.3 → 1.2.4

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 (161) 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/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/tools/sessionManager.js +79 -10
  20. package/build/tools/todoTools.js +39 -39
  21. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  22. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  23. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  24. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  25. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  26. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  27. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  28. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  29. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  30. package/commands/README.md +122 -122
  31. package/commands/ask.toml +72 -72
  32. package/commands/brainstorm.toml +119 -119
  33. package/commands/chat.toml +77 -77
  34. package/commands/code-preview.toml +37 -37
  35. package/commands/code.toml +28 -28
  36. package/commands/content.toml +200 -200
  37. package/commands/cook.toml +77 -77
  38. package/commands/copywrite.toml +131 -131
  39. package/commands/db.toml +192 -192
  40. package/commands/debug.toml +166 -166
  41. package/commands/design.toml +158 -158
  42. package/commands/dev-rules.toml +14 -14
  43. package/commands/do.toml +117 -117
  44. package/commands/doc-rules.toml +14 -14
  45. package/commands/docs.toml +148 -148
  46. package/commands/fix.toml +440 -440
  47. package/commands/fullstack.toml +175 -175
  48. package/commands/git.toml +235 -235
  49. package/commands/help.toml +84 -84
  50. package/commands/integrate.toml +127 -127
  51. package/commands/journal.toml +136 -136
  52. package/commands/kit-setup.toml +40 -40
  53. package/commands/mcp.toml +183 -183
  54. package/commands/orchestration.toml +15 -15
  55. package/commands/plan.toml +171 -171
  56. package/commands/pm.toml +148 -148
  57. package/commands/pr.toml +50 -50
  58. package/commands/project.toml +32 -32
  59. package/commands/research.toml +117 -117
  60. package/commands/review-pr.toml +63 -63
  61. package/commands/review.toml +190 -190
  62. package/commands/scout-ext.toml +97 -97
  63. package/commands/scout.toml +79 -79
  64. package/commands/screenshot.toml +65 -65
  65. package/commands/session.toml +102 -102
  66. package/commands/skill.toml +384 -384
  67. package/commands/status.toml +22 -22
  68. package/commands/team.toml +56 -56
  69. package/commands/test.toml +164 -164
  70. package/commands/ticket.toml +70 -70
  71. package/commands/use.toml +106 -106
  72. package/commands/video.toml +83 -83
  73. package/commands/watzup.toml +71 -71
  74. package/commands/workflow.toml +14 -14
  75. package/package.json +35 -35
  76. package/skills/meta/README.md +30 -30
  77. package/skills/meta/api-design/SKILL.md +134 -134
  78. package/skills/meta/code-review/SKILL.md +44 -44
  79. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  80. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  81. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  82. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  83. package/skills/meta/compound-docs/SKILL.md +133 -133
  84. package/skills/meta/debug/SKILL.md +40 -40
  85. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  86. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  87. package/skills/meta/docker/SKILL.md +126 -126
  88. package/skills/meta/examples/supabase/SKILL.md +46 -46
  89. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  90. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  91. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  92. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  93. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  94. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  95. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  96. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  97. package/skills/meta/file-todos/SKILL.md +88 -88
  98. package/skills/meta/mobile/SKILL.md +140 -140
  99. package/skills/meta/nextjs/SKILL.md +101 -101
  100. package/skills/meta/performance/SKILL.md +130 -130
  101. package/skills/meta/react-patterns/SKILL.md +83 -83
  102. package/skills/meta/security/SKILL.md +114 -114
  103. package/skills/meta/session-resume/SKILL.md +96 -96
  104. package/skills/meta/tailwind/SKILL.md +139 -139
  105. package/skills/meta/testing/SKILL.md +43 -43
  106. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  107. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  108. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  109. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  110. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  111. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  112. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  113. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  114. package/skills/tech/alpha-vantage/references/options.md +93 -93
  115. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  116. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  117. package/skills/tech/financial-modeling/SKILL.md +18 -18
  118. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  119. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  121. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  122. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  123. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  124. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  125. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  126. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  127. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  128. package/skills/workflows/README.md +203 -203
  129. package/skills/workflows/adr.md +174 -174
  130. package/skills/workflows/changelog.md +74 -74
  131. package/skills/workflows/compound.md +323 -323
  132. package/skills/workflows/compound_health.md +74 -74
  133. package/skills/workflows/create-agent-skill.md +138 -138
  134. package/skills/workflows/cycle.md +144 -144
  135. package/skills/workflows/deploy-docs.md +84 -84
  136. package/skills/workflows/development-rules.md +42 -42
  137. package/skills/workflows/doc.md +95 -95
  138. package/skills/workflows/documentation-management.md +34 -34
  139. package/skills/workflows/explore.md +146 -146
  140. package/skills/workflows/generate_command.md +106 -106
  141. package/skills/workflows/heal-skill.md +97 -97
  142. package/skills/workflows/housekeeping.md +229 -229
  143. package/skills/workflows/kit-setup.md +102 -102
  144. package/skills/workflows/map-codebase.md +78 -78
  145. package/skills/workflows/orchestration-protocol.md +43 -43
  146. package/skills/workflows/plan-compound.md +439 -439
  147. package/skills/workflows/plan_review.md +269 -269
  148. package/skills/workflows/primary-workflow.md +37 -37
  149. package/skills/workflows/promote_pattern.md +86 -86
  150. package/skills/workflows/release-docs.md +82 -82
  151. package/skills/workflows/report-bug.md +135 -135
  152. package/skills/workflows/reproduce-bug.md +118 -118
  153. package/skills/workflows/resolve_pr.md +133 -133
  154. package/skills/workflows/resolve_todo.md +128 -128
  155. package/skills/workflows/review-compound.md +376 -376
  156. package/skills/workflows/skill-review.md +127 -127
  157. package/skills/workflows/specs.md +257 -257
  158. package/skills/workflows/triage-sprint.md +102 -102
  159. package/skills/workflows/triage.md +152 -152
  160. package/skills/workflows/work.md +399 -399
  161. 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 `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
+ ---
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,138 +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
- ```
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
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