Skip to content

Commit 36a080d

Browse files
authored
docs(skill): improve using-systematic skill flow diagram (#81)
- Add planning mode decision point to skill flow diagram - Include brainstorming prerequisite before skill application check - Remove outdated skill resolution hierarchy (project, user, bundled) - Clarify that bundled skills are accessed via systematic_skill tool
1 parent dd1d052 commit 36a080d

1 file changed

Lines changed: 8 additions & 5 deletions

File tree

skills/using-systematic/SKILL.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,9 @@ Use the `systematic_skill` tool for Systematic bundled skills. Use the native `s
2424
```dot
2525
digraph skill_flow {
2626
"User message received" [shape=doublecircle];
27+
"About to enter Plan mode?" [shape=doublecircle];
28+
"Already brainstormed?" [shape=diamond];
29+
"Invoke brainstorming skill" [shape=box];
2730
"Might any skill apply?" [shape=diamond];
2831
"Invoke `systematic_skill` tool" [shape=box];
2932
"Announce: 'Using [skill] to [purpose]'" [shape=box];
@@ -32,6 +35,11 @@ digraph skill_flow {
3235
"Follow skill exactly" [shape=box];
3336
"Respond (including clarifications)" [shape=doublecircle];
3437
38+
"About to enter Plan mode?" -> "Already brainstormed?";
39+
"Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];
40+
"Already brainstormed?" -> "Might any skill apply?" [label="yes"];
41+
"Invoke brainstorming skill" -> "Might any skill apply?";
42+
3543
"User message received" -> "Might any skill apply?";
3644
"Might any skill apply?" -> "Invoke `systematic_skill` tool" [label="yes, even 1%"];
3745
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
@@ -86,9 +94,4 @@ Instructions say WHAT, not HOW. "Add X" or "Fix Y" doesn't mean skip workflows.
8694

8795
## Skill Resolution
8896

89-
Skills are resolved in priority order:
90-
1. **Project skills**: `.opencode/skills/` in current project
91-
2. **User skills**: `~/.config/opencode/skills/`
92-
3. **Bundled skills**: Provided by systematic plugin
93-
9497
Systematic bundled skills are listed in the `systematic_skill` tool description. Use the native `skill` tool for skills outside the Systematic plugin.

0 commit comments

Comments
 (0)