Skip to content

Commit 493ac3c

Browse files
Dchuong03claude
andcommitted
fix: rewrite skills to follow skill-creator standard
Changes: - Remove user-invocable field from all skills - Add clear trigger keywords in descriptions - Trim content to be more concise - Add explicit MCP tool usage examples Skills fixed: - sidstack-aware: clearer task management triggers - sidstack-impact-safe: trimmed, focused - sidstack-knowledge-first: trimmed, focused - sidstack-lesson-detector: trimmed examples - sidstack-training-context: trimmed examples Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 5a4a3ad commit 493ac3c

5 files changed

Lines changed: 139 additions & 413 deletions

File tree

Lines changed: 37 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,54 @@
11
---
22
name: sidstack-aware
3-
description: Use SidStack MCP tools for project management. Automatically apply when working on code changes, tasks, or needing project context.
4-
user-invocable: false
3+
description: >
4+
Use SidStack MCP tools for project management. Trigger when: (1) user asks to
5+
"check task", "list tasks", or mentions "task" (use task_list), (2) user asks to
6+
create/add/implement feature (use task_create), (3) working on code changes (use
7+
task_update with progress), (4) completing work (use task_complete).
58
---
69

7-
# SidStack Integration
8-
9-
You have access to SidStack MCP tools. Use them when appropriate:
10+
# SidStack MCP Tools
1011

1112
## Task Management
1213

13-
- `task_list({projectId, preset: "actionable"})` — see current work
14-
- `task_create({title, description, projectId})` — track new work
15-
- `task_update({taskId, progress, status})` — report progress at milestones (30%, 60%, 90%)
16-
- `task_complete({taskId})` — finish with quality gate check
14+
| Action | Tool | Example |
15+
|--------|------|---------|
16+
| Check tasks | `task_list({projectId: "folder-name"})` | "check task", "what tasks" |
17+
| Create task | `task_create({projectId, title, description})` | "implement X", "add feature" |
18+
| Update progress | `task_update({taskId, progress: 50})` | During implementation |
19+
| Complete | `task_complete({taskId})` | After finishing work |
1720

1821
## Knowledge
1922

20-
- `knowledge_search({projectPath, query})` — find patterns, decisions, business logic
21-
- `knowledge_context({projectPath, moduleId})` — get context for a module
23+
| Action | Tool | When |
24+
|--------|------|------|
25+
| Search | `knowledge_search({projectPath: ".", query})` | Before implementing |
26+
| Context | `knowledge_context({projectPath: ".", moduleId})` | Understanding module |
2227

2328
## Impact Analysis
2429

25-
- `impact_analyze({description})` — assess risk before significant changes
26-
- `impact_check_gate({analysisId})` — check if safe to proceed
30+
| Action | Tool | When |
31+
|--------|------|------|
32+
| Analyze | `impact_analyze({description})` | Before risky changes |
33+
| Check gate | `impact_check_gate({analysisId})` | After analysis |
34+
35+
## Quick Reference
2736

28-
## When to Use
37+
```
38+
# User says "check task" or "list tasks"
39+
task_list({ projectId: "project-folder-name" })
2940
30-
- **Starting implementation?**`knowledge_search` first to find existing patterns
31-
- **Changing core modules?**`impact_analyze` first to assess risk
32-
- **Working on task?**`task_update(progress)` at milestones
33-
- **Completing work?**`task_complete` to run quality gates
41+
# User wants to implement something
42+
task_create({
43+
projectId: "project-folder-name",
44+
title: "[feature] Description",
45+
description: "What and why",
46+
taskType: "feature"
47+
})
3448
35-
## Tool Reference
49+
# During work - update progress
50+
task_update({ taskId: "xxx", progress: 50, status: "in_progress" })
3651
37-
| Category | Tools |
38-
|----------|-------|
39-
| Tasks | `task_list`, `task_create`, `task_update`, `task_complete`, `task_get` |
40-
| Knowledge | `knowledge_list`, `knowledge_get`, `knowledge_search`, `knowledge_context` |
41-
| Impact | `impact_analyze`, `impact_check_gate`, `impact_list` |
42-
| Tickets | `ticket_list`, `ticket_create`, `ticket_update`, `ticket_convert_to_task` |
43-
| Training | `lesson_create`, `skill_create`, `rule_check` |
44-
| Sessions | `session_launch` |
52+
# Done - complete task
53+
task_complete({ taskId: "xxx" })
54+
```
Lines changed: 21 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,72 +1,43 @@
11
---
22
name: sidstack-impact-safe
3-
description: Run impact analysis before modifying core modules, APIs, or database schemas.
4-
user-invocable: false
3+
description: >
4+
Run impact analysis before risky changes. Trigger when: modifying core modules
5+
(shared, database, auth), changing APIs or schemas, touching security code,
6+
or affecting multiple modules. Use impact_analyze then impact_check_gate.
57
---
68

79
# Impact-Safe Changes
810

9-
Before modifying critical code, run impact analysis to understand risks and dependencies.
11+
## When to Run Impact Analysis
1012

11-
## When to Apply
12-
13-
Run `impact_analyze` before touching:
14-
15-
- **Core modules**: packages/shared, src-tauri, database
16-
- **APIs**: Route handlers, request/response schemas
17-
- **Database**: Schema changes, migrations
18-
- **Security**: Authentication, authorization, encryption
19-
- **Integrations**: External services, MCP tools
13+
- Modifying core modules (database, auth, shared)
14+
- Changing API routes or response schemas
15+
- Database schema changes or migrations
16+
- Security-related code (auth, encryption)
17+
- Changes affecting 3+ files across modules
2018

2119
## Process
2220

23-
### Step 1: Analyze Impact
21+
### 1. Analyze
2422

2523
```
2624
impact_analyze({
2725
description: "What you're changing and why",
28-
targetModules: ["affected-module-1", "affected-module-2"],
29-
changeType: "feature" | "refactor" | "bugfix" | "migration" | "deletion"
26+
targetModules: ["module1", "module2"],
27+
changeType: "feature" | "refactor" | "bugfix" | "migration"
3028
})
3129
```
3230

33-
### Step 2: Check Gate Status
31+
### 2. Check Gate
3432

3533
```
36-
impact_check_gate({
37-
analysisId: "from-step-1"
38-
})
34+
impact_check_gate({ analysisId: "from-step-1" })
3935
```
4036

41-
### Step 3: Interpret Results
42-
43-
| Status | Meaning | Action |
44-
|--------|---------|--------|
45-
| `clear` | Safe to proceed | Continue with implementation |
46-
| `warning` | Caution needed | Review risks, proceed carefully |
47-
| `blocked` | High risk | Address blockers before proceeding |
48-
49-
## Risk Indicators
50-
51-
**High Risk:**
52-
- Breaking API changes
53-
- Database schema modifications
54-
- Security-sensitive code changes
55-
- Multiple modules affected
56-
57-
**Medium Risk:**
58-
- Internal API changes
59-
- Adding new dependencies
60-
- Modifying shared utilities
61-
62-
**Low Risk:**
63-
- Isolated bug fixes
64-
- Documentation updates
65-
- Test additions
66-
67-
## Best Practices
37+
### 3. Interpret
6838

69-
1. **Always analyze before implementing** risky changes
70-
2. **Document the analysis** in your commit message
71-
3. **If blocked**, create tasks to address blockers first
72-
4. **If warning**, add extra tests for affected areas
39+
| Status | Action |
40+
|--------|--------|
41+
| `clear` | Safe to proceed |
42+
| `warning` | Proceed with extra care |
43+
| `blocked` | Fix blockers first |
Lines changed: 16 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,23 @@
11
---
22
name: sidstack-knowledge-first
3-
description: Search SidStack knowledge before implementing features or making architectural decisions.
4-
user-invocable: false
3+
description: >
4+
Search project knowledge before implementing. Trigger when: starting a new
5+
feature, making architectural decisions, working in unfamiliar code, or
6+
modifying business logic. Use knowledge_search and knowledge_context.
57
---
68

79
# Knowledge-First Development
810

9-
Before implementing features or making architectural decisions, search existing knowledge to ensure consistency with the codebase.
11+
## When to Search Knowledge
1012

11-
## When to Apply
12-
13-
- Implementing a new feature
13+
- Starting a new feature implementation
1414
- Making architectural decisions
15-
- Modifying business logic
16-
- Changing data models or APIs
17-
- Working in unfamiliar parts of the codebase
15+
- Working in unfamiliar modules
16+
- Changing business logic or data models
1817

1918
## Process
2019

21-
### Step 1: Search for Existing Patterns
20+
### 1. Search for Patterns
2221

2322
```
2423
knowledge_search({
@@ -27,15 +26,7 @@ knowledge_search({
2726
})
2827
```
2928

30-
Look for:
31-
- Similar implementations
32-
- Design patterns used
33-
- Business rules documented
34-
- API conventions
35-
36-
### Step 2: Get Module Context
37-
38-
If working in a specific module:
29+
### 2. Get Module Context
3930

4031
```
4132
knowledge_context({
@@ -44,31 +35,10 @@ knowledge_context({
4435
})
4536
```
4637

47-
This provides:
48-
- Module overview and purpose
49-
- Related documentation
50-
- Dependencies and relationships
51-
- Known constraints
52-
53-
### Step 3: Check for Related Decisions
54-
55-
Search for architectural decisions:
38+
## What to Look For
5639

57-
```
58-
knowledge_search({
59-
projectPath: ".",
60-
query: "decision architecture"
61-
})
62-
```
63-
64-
Look in:
65-
- `.sidstack/knowledge/` for documented patterns
66-
- `openspec/` for change proposals
67-
- `docs/` for technical documentation
68-
69-
## Benefits
70-
71-
- **Consistency**: Follow established patterns
72-
- **Efficiency**: Don't reinvent existing solutions
73-
- **Quality**: Build on proven approaches
74-
- **Context**: Understand why things are the way they are
40+
- Similar implementations
41+
- Design patterns used
42+
- Business rules
43+
- API conventions
44+
- Known constraints

0 commit comments

Comments
 (0)