add docs/guide.md, update skill structure, add guide reference to all workflows

This commit is contained in:
lyn
2026-04-17 14:11:46 +00:00
parent 71a15e2eaa
commit 315cf46889
5 changed files with 40 additions and 10 deletions

View File

@@ -6,6 +6,9 @@ Used when you notice patterns or workflows that could improve efficiency but hav
Not every repetitive task needs to become a skill. Ask first: is this pattern general enough to warrant abstraction?
> See `{baseDir}/docs/guide.md` for skill structure and writing requirements.
## Process
### 1. Identify the Pattern

View File

@@ -6,6 +6,8 @@ Used when a skill or its scripts fail to produce expected results, or throw erro
**Do not resort to workarounds lightly.** Identify the root cause first, then fix properly.
> See `{baseDir}/docs/guide.md` for skill structure and writing requirements.
## Process
### 1. Gather Information

View File

@@ -17,12 +17,16 @@ Improvement is better than workaround. Fix problems when you find them, so other
- Improving or correcting existing skills
- Any other documentation within skills
> See `{baseDir}/docs/guide.md` for skill structure and writing requirements.
## Process
### 1. Identify the Problem
- Record which skill and which part has the issue
- Describe specifically: what's misleading, what's missing, what's not working well
- Record the scenario where you encountered it- Record which skill and which part has the issue
- Describe specifically: what's misleading, what's missing, what's not working well
- Record the scenario where you encountered it
### 2. Assess Impact