Problem: 11 skill descriptions currently contain process/workflow summaries that Claude may interpret as instructions to follow or implement, rather than triggers for when the skill should be used.
Example: "This skill helps with X by doing Y and then Z" (sounds like instructions)
Should be: "This skill should be used when you need to X" (trigger-only)
Solution:
- Audit all 26 skill descriptions in
shared/skills/*/SKILL.md
- Rewrite descriptions to trigger-only format starting with "This skill should be used when..."
- Document format standard in CLAUDE.md
- Verify descriptions cannot be misinterpreted as commands/instructions
Acceptance Criteria:
- All 26 skill descriptions use trigger-only format
- No descriptions contain process/workflow summaries
- Format documented in project guidelines
- Code review validates no regressions
Related to: #78
Problem: 11 skill descriptions currently contain process/workflow summaries that Claude may interpret as instructions to follow or implement, rather than triggers for when the skill should be used.
Example: "This skill helps with X by doing Y and then Z" (sounds like instructions)
Should be: "This skill should be used when you need to X" (trigger-only)
Solution:
shared/skills/*/SKILL.mdAcceptance Criteria:
Related to: #78