Skip to content

Commit c9b53ba

Browse files
committed
fix(skill-maker): use generic example paths, clarify routing targets
- xml-structure-guide.md: replace skill-specific paths (to-issue.md, refine.md, auth.md) with generic placeholders (command-a.md, setup.md) so agents don't confuse examples with real local files - SKILL.md: replace vague 'Follow ... below' routing targets with specific section names and file paths
1 parent 1a9f2fc commit c9b53ba

2 files changed

Lines changed: 11 additions & 11 deletions

File tree

skills/skill-maker/SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ What do you need to do?
2121

2222
| Response | Workflow |
2323
|----------|----------|
24-
| 1, "audit", "review", "check", "fix", "improve" | Follow the Audit Workflow below |
25-
| 2, "create", "write", "build", "new", "draft" | Follow Phases 1–5 below |
26-
| 3, "consolidate", "merge", "combine" | Read `references/consolidation-guide.md` and follow its workflow. Return to Phase 5 (Review) for the final checklist. |
24+
| 1, "audit", "review", "check", "fix", "improve" | Audit Workflow (Step 1–4 in this file) |
25+
| 2, "create", "write", "build", "new", "draft" | Phases 1–5 (Interview → Draft → Description → Scripts → Review) in this file |
26+
| 3, "consolidate", "merge", "combine" | `references/consolidation-guide.md` — return to Phase 5 for final checklist |
2727

2828
</routing>
2929

skills/skill-maker/references/xml-structure-guide.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -73,19 +73,19 @@ The `<intake>` and `<routing>` tags form a natural pair. Keep them adjacent:
7373
<intake>
7474
## What would you like to do?
7575

76-
1. **Create an issue** — New feature, epic, story, task, or bug
77-
2. **Refine an issue** — Size, complete fields, challenge scope
78-
3. **Plan the sprint** — Capacity, assignments, sprint goals
76+
1. **Command A** — Short description of first option
77+
2. **Command B** — Short description of second option
78+
3. **Command C** — Short description of third option
7979

8080
**Wait for response before proceeding.**
8181
</intake>
8282

8383
<routing>
8484
| Response | Workflow |
8585
|----------|----------|
86-
| 1, "create", "new issue" | `references/to-issue.md` |
87-
| 2, "refine", "groom" | `references/refine.md` |
88-
| 3, "plan", "sprint" | `references/plan.md` |
86+
| 1, "keyword-a" | `references/command-a.md` |
87+
| 2, "keyword-b" | `references/command-b.md` |
88+
| 3, "keyword-c" | `references/command-c.md` |
8989
</routing>
9090
```
9191

@@ -98,8 +98,8 @@ The `<reference_index>` tag replaces a flat markdown list with structured guidan
9898

9999
| Reference | Purpose | Path |
100100
|-----------|---------|------|
101-
| sources | Lifecycle URLs per platform | `references/sources.md` |
102-
| auth | Token setup and curl patterns | `../rhdh-jira/references/auth.md` |
101+
| setup | Environment setup and prerequisites | `references/setup.md` |
102+
| patterns | Reusable patterns for common tasks | `references/patterns.md` |
103103

104104
</reference_index>
105105
```

0 commit comments

Comments
 (0)