superkit-mcp-server 1.2.4 → 1.2.6

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