superkit-mcp-server 1.1.4 → 1.2.0

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