superkit-mcp-server 1.2.1 → 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.
- 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/security-auditor.md +3 -2
- package/agents/tester.md +274 -274
- package/agents/ui-designer.md +208 -208
- package/build/index.js +21 -2
- package/build/tools/__tests__/loggerTools.test.js +5 -5
- package/build/tools/archTools.js +2 -19
- package/build/tools/autoPreview.js +2 -2
- package/build/tools/compoundTools.js +4 -4
- package/build/tools/docsTools.js +5 -10
- package/build/tools/loggerTools.js +1 -1
- 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/build/tools/validators/convertRules.js +2 -2
- 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 +171 -171
- 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/doc.md +6 -6
- 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 -139
- 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,106 +1,106 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Create new workflow commands dynamically. Use to extend the workflow system.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /generate_command - Create New Commands
|
|
6
|
-
|
|
7
|
-
Generate new workflow commands with proper structure.
|
|
8
|
-
|
|
9
|
-
## Workflow
|
|
10
|
-
|
|
11
|
-
### Step 0: Search & Log
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
// turbo
|
|
15
|
-
Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/generate_command", outcome: "success" }
|
|
16
|
-
Call MCP `call_tool_compound_manager` { action: "search", terms: [ "workflow command"] }
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
### Step 1: Define Command
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
Command name: {name}
|
|
23
|
-
Description: {what it does}
|
|
24
|
-
When to use: {trigger conditions}
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
### Step 2: Create File
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
cat >
|
|
31
|
-
---
|
|
32
|
-
description: {description}
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
# /{name} - {Title}
|
|
36
|
-
|
|
37
|
-
{Purpose and overview}
|
|
38
|
-
|
|
39
|
-
## When To Use
|
|
40
|
-
|
|
41
|
-
- {Condition 1}
|
|
42
|
-
- {Condition 2}
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## Workflow
|
|
47
|
-
|
|
48
|
-
### Step 1: {First Step}
|
|
49
|
-
|
|
50
|
-
{Instructions}
|
|
51
|
-
|
|
52
|
-
### Step 2: {Second Step}
|
|
53
|
-
|
|
54
|
-
{Instructions}
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## References
|
|
59
|
-
|
|
60
|
-
- {Related command}: `/{command}`
|
|
61
|
-
EOF
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
### Step 3: Verify
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
# Check file exists
|
|
68
|
-
cat
|
|
69
|
-
|
|
70
|
-
# Test invocation
|
|
71
|
-
/{name}
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
### Phase 5: Completion & Handoff
|
|
75
|
-
|
|
76
|
-
#### Step 1: Establish Terminal UI State
|
|
77
|
-
|
|
78
|
-
```javascript
|
|
79
|
-
await task_boundary({
|
|
80
|
-
TaskName: "[COMPLETED] Generate Command: /{name}",
|
|
81
|
-
TaskStatus: "Command generated and verified. Offering next steps.",
|
|
82
|
-
Mode: "VERIFICATION",
|
|
83
|
-
TaskSummary: "Generated new workflow command /{name}: {description}. Verified file creation."
|
|
84
|
-
});
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
#### Step 2: Mandatory Handoff
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
✓ Command generated: /{name}
|
|
91
|
-
|
|
92
|
-
Next steps:
|
|
93
|
-
1. /{name} - Test the new command
|
|
94
|
-
2. /housekeeping - Verify integration
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## Template Structure
|
|
100
|
-
|
|
101
|
-
All commands should have:
|
|
102
|
-
- YAML frontmatter with `description`
|
|
103
|
-
- Clear title and purpose
|
|
104
|
-
- "When To Use" section
|
|
105
|
-
- Numbered workflow steps
|
|
106
|
-
- References to related commands
|
|
1
|
+
---
|
|
2
|
+
description: Create new workflow commands dynamically. Use to extend the workflow system.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /generate_command - Create New Commands
|
|
6
|
+
|
|
7
|
+
Generate new workflow commands with proper structure.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
### Step 0: Search & Log
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
// turbo
|
|
15
|
+
Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/generate_command", outcome: "success" }
|
|
16
|
+
Call MCP `call_tool_compound_manager` { action: "search", terms: [ "workflow command"] }
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Step 1: Define Command
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
Command name: {name}
|
|
23
|
+
Description: {what it does}
|
|
24
|
+
When to use: {trigger conditions}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### Step 2: Create File
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
cat > skills/workflows/{name}.md << 'EOF'
|
|
31
|
+
---
|
|
32
|
+
description: {description}
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
# /{name} - {Title}
|
|
36
|
+
|
|
37
|
+
{Purpose and overview}
|
|
38
|
+
|
|
39
|
+
## When To Use
|
|
40
|
+
|
|
41
|
+
- {Condition 1}
|
|
42
|
+
- {Condition 2}
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Workflow
|
|
47
|
+
|
|
48
|
+
### Step 1: {First Step}
|
|
49
|
+
|
|
50
|
+
{Instructions}
|
|
51
|
+
|
|
52
|
+
### Step 2: {Second Step}
|
|
53
|
+
|
|
54
|
+
{Instructions}
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## References
|
|
59
|
+
|
|
60
|
+
- {Related command}: `/{command}`
|
|
61
|
+
EOF
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Step 3: Verify
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
# Check file exists
|
|
68
|
+
cat skills/workflows/{name}.md
|
|
69
|
+
|
|
70
|
+
# Test invocation
|
|
71
|
+
/{name}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Phase 5: Completion & Handoff
|
|
75
|
+
|
|
76
|
+
#### Step 1: Establish Terminal UI State
|
|
77
|
+
|
|
78
|
+
```javascript
|
|
79
|
+
await task_boundary({
|
|
80
|
+
TaskName: "[COMPLETED] Generate Command: /{name}",
|
|
81
|
+
TaskStatus: "Command generated and verified. Offering next steps.",
|
|
82
|
+
Mode: "VERIFICATION",
|
|
83
|
+
TaskSummary: "Generated new workflow command /{name}: {description}. Verified file creation."
|
|
84
|
+
});
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
#### Step 2: Mandatory Handoff
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
✓ Command generated: /{name}
|
|
91
|
+
|
|
92
|
+
Next steps:
|
|
93
|
+
1. /{name} - Test the new command
|
|
94
|
+
2. /housekeeping - Verify integration
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Template Structure
|
|
100
|
+
|
|
101
|
+
All commands should have:
|
|
102
|
+
- YAML frontmatter with `description`
|
|
103
|
+
- Clear title and purpose
|
|
104
|
+
- "When To Use" section
|
|
105
|
+
- Numbered workflow steps
|
|
106
|
+
- References to related commands
|
|
@@ -1,97 +1,97 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Diagnose and fix broken skills. Use when a skill isn't working correctly.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /heal-skill - Skill Maintenance
|
|
6
|
-
|
|
7
|
-
Diagnose and repair skills that aren't functioning correctly.
|
|
8
|
-
|
|
9
|
-
## Workflow
|
|
10
|
-
|
|
11
|
-
### Step 0: Search & Log
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
// turbo
|
|
15
|
-
Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/heal-skill", outcome: "success" }
|
|
16
|
-
Call MCP `call_tool_compound_manager` { action: "search", terms: [ "broken skill"] }
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
### Step 1: Identify the Issue
|
|
20
|
-
|
|
21
|
-
Common problems:
|
|
22
|
-
- [ ] SKILL.md not loading
|
|
23
|
-
- [ ] Workflow not found
|
|
24
|
-
- [ ] Missing references
|
|
25
|
-
- [ ] Broken file paths
|
|
26
|
-
|
|
27
|
-
### Step 2: Diagnose
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
# Check skill exists
|
|
31
|
-
ls skills/{skill-name}/
|
|
32
|
-
|
|
33
|
-
# Verify SKILL.md
|
|
34
|
-
cat skills/{skill-name}/SKILL.md
|
|
35
|
-
Call MCP `call_tool_logger_manager` { action: "logSkill", name: "{skill-name}", outcome: "workflow" }
|
|
36
|
-
|
|
37
|
-
# Check for broken links
|
|
38
|
-
grep -r "Read \`" skills/{skill-name}/ | while read line; do
|
|
39
|
-
path=$(echo "$line" | grep -o '`[^`]*`' | tr -d '`')
|
|
40
|
-
[ -f "skills/{skill-name}/$path" ] || echo "Missing: $path"
|
|
41
|
-
done
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
### Step 3: Common Fixes
|
|
45
|
-
|
|
46
|
-
**SKILL.md not structured correctly:**
|
|
47
|
-
- Add proper YAML frontmatter
|
|
48
|
-
- Include clear router section
|
|
49
|
-
|
|
50
|
-
**Missing workflows:**
|
|
51
|
-
- Create the referenced workflow file
|
|
52
|
-
- Update router to match actual files
|
|
53
|
-
|
|
54
|
-
**Broken references:**
|
|
55
|
-
- Fix file paths
|
|
56
|
-
- Update relative paths
|
|
57
|
-
|
|
58
|
-
### Step 4: Verify Fix
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
# Test skill invocation
|
|
62
|
-
# Check all workflows accessible
|
|
63
|
-
# Verify references load
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
### Phase 5: Completion & Handoff
|
|
67
|
-
|
|
68
|
-
#### Step 1: Establish Terminal UI State
|
|
69
|
-
|
|
70
|
-
```javascript
|
|
71
|
-
await task_boundary({
|
|
72
|
-
TaskName: "[COMPLETED] Heal Skill: {Skill Name}",
|
|
73
|
-
TaskStatus: "Skill diagnosed and repaired. Offering next steps.",
|
|
74
|
-
Mode: "VERIFICATION",
|
|
75
|
-
TaskSummary: "Diagnosed issues in skill {name}. Applied fixes: {fixes}. Verified functionality."
|
|
76
|
-
});
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
#### Step 2: Mandatory Handoff
|
|
80
|
-
|
|
81
|
-
```bash
|
|
82
|
-
✓ Skill healed
|
|
83
|
-
|
|
84
|
-
Next steps:
|
|
85
|
-
1. /create-agent-skill - Extend capabilities further
|
|
86
|
-
2. /work - Resume original task
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## Skill Health Checklist
|
|
92
|
-
|
|
93
|
-
- [ ] YAML frontmatter present
|
|
94
|
-
- [ ] Description clear
|
|
95
|
-
- [ ] Router section works
|
|
96
|
-
- [ ] All workflows exist
|
|
97
|
-
- [ ] References accessible
|
|
1
|
+
---
|
|
2
|
+
description: Diagnose and fix broken skills. Use when a skill isn't working correctly.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /heal-skill - Skill Maintenance
|
|
6
|
+
|
|
7
|
+
Diagnose and repair skills that aren't functioning correctly.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
### Step 0: Search & Log
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
// turbo
|
|
15
|
+
Call MCP `call_tool_logger_manager` { action: "logWorkflow", name: "/heal-skill", outcome: "success" }
|
|
16
|
+
Call MCP `call_tool_compound_manager` { action: "search", terms: [ "broken skill"] }
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Step 1: Identify the Issue
|
|
20
|
+
|
|
21
|
+
Common problems:
|
|
22
|
+
- [ ] SKILL.md not loading
|
|
23
|
+
- [ ] Workflow not found
|
|
24
|
+
- [ ] Missing references
|
|
25
|
+
- [ ] Broken file paths
|
|
26
|
+
|
|
27
|
+
### Step 2: Diagnose
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# Check skill exists
|
|
31
|
+
ls skills/{skill-name}/
|
|
32
|
+
|
|
33
|
+
# Verify SKILL.md
|
|
34
|
+
cat skills/{skill-name}/SKILL.md
|
|
35
|
+
Call MCP `call_tool_logger_manager` { action: "logSkill", name: "{skill-name}", outcome: "workflow" }
|
|
36
|
+
|
|
37
|
+
# Check for broken links
|
|
38
|
+
grep -r "Read \`" skills/{skill-name}/ | while read line; do
|
|
39
|
+
path=$(echo "$line" | grep -o '`[^`]*`' | tr -d '`')
|
|
40
|
+
[ -f "skills/{skill-name}/$path" ] || echo "Missing: $path"
|
|
41
|
+
done
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Step 3: Common Fixes
|
|
45
|
+
|
|
46
|
+
**SKILL.md not structured correctly:**
|
|
47
|
+
- Add proper YAML frontmatter
|
|
48
|
+
- Include clear router section
|
|
49
|
+
|
|
50
|
+
**Missing workflows:**
|
|
51
|
+
- Create the referenced workflow file
|
|
52
|
+
- Update router to match actual files
|
|
53
|
+
|
|
54
|
+
**Broken references:**
|
|
55
|
+
- Fix file paths
|
|
56
|
+
- Update relative paths
|
|
57
|
+
|
|
58
|
+
### Step 4: Verify Fix
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# Test skill invocation
|
|
62
|
+
# Check all workflows accessible
|
|
63
|
+
# Verify references load
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Phase 5: Completion & Handoff
|
|
67
|
+
|
|
68
|
+
#### Step 1: Establish Terminal UI State
|
|
69
|
+
|
|
70
|
+
```javascript
|
|
71
|
+
await task_boundary({
|
|
72
|
+
TaskName: "[COMPLETED] Heal Skill: {Skill Name}",
|
|
73
|
+
TaskStatus: "Skill diagnosed and repaired. Offering next steps.",
|
|
74
|
+
Mode: "VERIFICATION",
|
|
75
|
+
TaskSummary: "Diagnosed issues in skill {name}. Applied fixes: {fixes}. Verified functionality."
|
|
76
|
+
});
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
#### Step 2: Mandatory Handoff
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
✓ Skill healed
|
|
83
|
+
|
|
84
|
+
Next steps:
|
|
85
|
+
1. /create-agent-skill - Extend capabilities further
|
|
86
|
+
2. /work - Resume original task
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Skill Health Checklist
|
|
92
|
+
|
|
93
|
+
- [ ] YAML frontmatter present
|
|
94
|
+
- [ ] Description clear
|
|
95
|
+
- [ ] Router section works
|
|
96
|
+
- [ ] All workflows exist
|
|
97
|
+
- [ ] References accessible
|