Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

fix(skill): prevent triage from duplicating co-loaded skill guidance (#1485)

worktrunk-botc64df1f1704e
diff --git a/.claude/skills/triage-issue/SKILL.md b/.claude/skills/triage-issue/SKILL.md
index b78e157f9..9ab9ed8dc 100644
--- a/.claude/skills/triage-issue/SKILL.md
+++ b/.claude/skills/triage-issue/SKILL.md
@@ -109,6 +109,19 @@ FONTES principle established in Step 1.
- Fix is localized (1-3 files changed)
- Confident the fix is correct
+### Skill text fixes
+
+When the bug is about bot behavior (e.g., "bot didn't use links", "bot posted
+wrong format"), the root cause is often a skill/prompt compliance issue, not
+missing code. Before adding guidance to a skill:
+
+1. **Check ALL co-loaded skills** — Skills loaded together in the same workflow
+ share context. If the guidance already exists in a co-loaded skill (e.g.,
+ `running-in-ci` is loaded alongside `review-pr` and `triage-issue`), the
+ issue is behavioral compliance, not missing instructions.
+2. **Don't duplicate guidance across skills** — Adding the same rule to multiple
+ co-loaded skills creates maintenance burden and doesn't fix compliance gaps.
+
### If fixing
1. Fix the root cause (not just the symptom)