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.
- package/ARCHITECTURE.md +102 -102
- package/README.md +71 -71
- package/SUPERKIT.md +168 -168
- package/agents/code-archaeologist.md +106 -106
- package/agents/coder.md +90 -90
- package/agents/data-engineer.md +28 -28
- package/agents/devops-engineer.md +242 -242
- package/agents/git-manager.md +203 -203
- package/agents/orchestrator.md +420 -420
- package/agents/penetration-tester.md +188 -188
- package/agents/performance-optimizer.md +187 -187
- package/agents/planner.md +270 -270
- package/agents/qa-automation-engineer.md +103 -103
- package/agents/quant-developer.md +32 -32
- package/agents/reviewer.md +100 -100
- package/agents/scout.md +222 -222
- package/agents/tester.md +274 -274
- package/agents/ui-designer.md +208 -208
- package/build/__tests__/test_apply_prompt_args.js +104 -0
- package/build/index.js +106 -45
- package/build/tools/todoTools.js +39 -39
- package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
- package/build/tools/validators/__tests__/convertRules.test.js +5 -5
- package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
- package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
- package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
- package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
- package/build/tools/validators/__tests__/securityScan.test.js +6 -6
- package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
- package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
- package/commands/README.md +122 -122
- package/commands/ask.toml +72 -72
- package/commands/brainstorm.toml +119 -119
- package/commands/chat.toml +77 -77
- package/commands/code-preview.toml +37 -37
- package/commands/code.toml +28 -28
- package/commands/content.toml +200 -200
- package/commands/cook.toml +77 -77
- package/commands/copywrite.toml +131 -131
- package/commands/db.toml +192 -192
- package/commands/debug.toml +166 -166
- package/commands/design.toml +158 -158
- package/commands/dev-rules.toml +14 -14
- package/commands/do.toml +117 -117
- package/commands/doc-rules.toml +14 -14
- package/commands/docs.toml +148 -148
- package/commands/fix.toml +440 -440
- package/commands/fullstack.toml +175 -175
- package/commands/git.toml +235 -235
- package/commands/help.toml +84 -84
- package/commands/integrate.toml +127 -127
- package/commands/journal.toml +136 -136
- package/commands/kit-setup.toml +40 -40
- package/commands/mcp.toml +183 -183
- package/commands/orchestration.toml +15 -15
- package/commands/plan.toml +206 -172
- package/commands/pm.toml +148 -148
- package/commands/pr.toml +50 -50
- package/commands/project.toml +32 -32
- package/commands/research.toml +117 -117
- package/commands/review-pr.toml +63 -63
- package/commands/review.toml +190 -190
- package/commands/scout-ext.toml +97 -97
- package/commands/scout.toml +79 -79
- package/commands/screenshot.toml +65 -65
- package/commands/session.toml +102 -102
- package/commands/skill.toml +384 -384
- package/commands/status.toml +22 -22
- package/commands/team.toml +56 -56
- package/commands/test.toml +164 -164
- package/commands/ticket.toml +70 -70
- package/commands/use.toml +106 -106
- package/commands/video.toml +83 -83
- package/commands/watzup.toml +71 -71
- package/commands/workflow.toml +14 -14
- package/package.json +35 -35
- package/skills/meta/README.md +30 -30
- package/skills/meta/api-design/SKILL.md +134 -134
- package/skills/meta/code-review/SKILL.md +44 -44
- package/skills/meta/code-review/checklists/pre-merge.md +25 -25
- package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
- package/skills/meta/code-review/workflows/performance-pass.md +27 -27
- package/skills/meta/code-review/workflows/security-pass.md +29 -29
- package/skills/meta/compound-docs/SKILL.md +133 -133
- package/skills/meta/debug/SKILL.md +40 -40
- package/skills/meta/debug/templates/bug-report.template.md +31 -31
- package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
- package/skills/meta/docker/SKILL.md +126 -126
- package/skills/meta/examples/supabase/SKILL.md +46 -46
- package/skills/meta/examples/supabase/references/best-practices.md +319 -319
- package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
- package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
- package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
- package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
- package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
- package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
- package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
- package/skills/meta/file-todos/SKILL.md +88 -88
- package/skills/meta/mobile/SKILL.md +140 -140
- package/skills/meta/nextjs/SKILL.md +101 -101
- package/skills/meta/performance/SKILL.md +130 -130
- package/skills/meta/react-patterns/SKILL.md +83 -83
- package/skills/meta/security/SKILL.md +114 -114
- package/skills/meta/session-resume/SKILL.md +96 -96
- package/skills/meta/tailwind/SKILL.md +139 -139
- package/skills/meta/testing/SKILL.md +43 -43
- package/skills/meta/testing/references/vitest-patterns.md +45 -45
- package/skills/meta/testing/templates/component-test.template.tsx +37 -37
- package/skills/tech/alpha-vantage/SKILL.md +142 -142
- package/skills/tech/alpha-vantage/references/commodities.md +153 -153
- package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
- package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
- package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
- package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
- package/skills/tech/alpha-vantage/references/options.md +93 -93
- package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
- package/skills/tech/alpha-vantage/references/time-series.md +157 -157
- package/skills/tech/financial-modeling/SKILL.md +18 -18
- package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
- package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
- package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
- package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
- package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
- package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
- package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
- package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
- package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
- package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
- package/skills/workflows/README.md +203 -203
- package/skills/workflows/adr.md +174 -174
- package/skills/workflows/changelog.md +74 -74
- package/skills/workflows/compound.md +323 -323
- package/skills/workflows/compound_health.md +74 -74
- package/skills/workflows/create-agent-skill.md +138 -138
- package/skills/workflows/cycle.md +144 -144
- package/skills/workflows/deploy-docs.md +84 -84
- package/skills/workflows/development-rules.md +42 -42
- package/skills/workflows/doc.md +95 -95
- package/skills/workflows/documentation-management.md +34 -34
- package/skills/workflows/explore.md +146 -146
- package/skills/workflows/generate_command.md +106 -106
- package/skills/workflows/heal-skill.md +97 -97
- package/skills/workflows/housekeeping.md +229 -229
- package/skills/workflows/kit-setup.md +102 -102
- package/skills/workflows/map-codebase.md +78 -78
- package/skills/workflows/orchestration-protocol.md +43 -43
- package/skills/workflows/plan-compound.md +439 -439
- package/skills/workflows/plan_review.md +269 -269
- package/skills/workflows/primary-workflow.md +37 -37
- package/skills/workflows/promote_pattern.md +86 -86
- package/skills/workflows/release-docs.md +82 -82
- package/skills/workflows/report-bug.md +135 -135
- package/skills/workflows/reproduce-bug.md +118 -118
- package/skills/workflows/resolve_pr.md +133 -133
- package/skills/workflows/resolve_todo.md +128 -128
- package/skills/workflows/review-compound.md +376 -376
- package/skills/workflows/skill-review.md +127 -127
- package/skills/workflows/specs.md +257 -257
- package/skills/workflows/triage-sprint.md +102 -102
- package/skills/workflows/triage.md +152 -152
- package/skills/workflows/work.md +399 -399
- 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
|