openclaw/skills
DylanWoodAkers cfd384ead2
feat(skills): improve descriptions with routing logic (#14577)
* feat(skills): improve descriptions with routing logic

Apply OpenAI's recommended pattern for skill descriptions:
- Add 'Use when' conditions for clear triggering
- Add 'NOT for' negative examples to reduce misfires
- Make descriptions act as routing logic, not marketing copy

Based on: https://developers.openai.com/blog/skills-shell-tips/

Skills updated:
- coding-agent: clarify when to delegate vs direct edit
- github: add boundaries vs browser/scripting
- weather: add scope limitations

Glean reported 20% drop in skill triggering without negative
examples, recovering after adding them. This change brings
Clawdbot skills in line with that pattern.

* docs(skills): clarify routing boundaries (openclaw#14577) (thanks @DylanWoodAkers)

* docs(changelog): add PR 14577 release note (openclaw#14577) (thanks @DylanWoodAkers)

---------

Co-authored-by: ClawdBotWolf <clawdbotwolf@proton.me>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-02-18 01:31:28 +01:00
..
1password chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
apple-notes chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
apple-reminders feat(skills): Add 'Use when / Don't use when' routing blocks (#14521) 2026-02-18 01:28:20 +01:00
bear-notes chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
blogwatcher chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
blucli chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
bluebubbles iMessage: promote BlueBubbles and refresh docs/skills (#8415) 2026-02-03 18:06:54 -08:00
camsnap chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
canvas chore: oxfmt fixes 2026-02-01 20:34:42 +00:00
clawhub chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
coding-agent feat(skills): improve descriptions with routing logic (#14577) 2026-02-18 01:31:28 +01:00
discord Discord: CV2! (#16364) 2026-02-15 10:24:53 -06:00
eightctl chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
food-order chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
gemini chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
gh-issues fix(skills): improve git credential handling for gh-issues sub-agents 2026-02-17 00:00:08 +01:00
gifgrep chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
github feat(skills): improve descriptions with routing logic (#14577) 2026-02-18 01:31:28 +01:00
gog chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
goplaces chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
healthcheck Skills: refine healthcheck guidance 2026-02-03 09:21:34 -06:00
himalaya chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
imsg feat(skills): Add 'Use when / Don't use when' routing blocks (#14521) 2026-02-18 01:28:20 +01:00
mcporter chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
model-usage chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
nano-banana-pro chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
nano-pdf chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
notion chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
obsidian chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
openai-image-gen chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
openai-whisper chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
openai-whisper-api chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
openhue feat(skills): Add 'Use when / Don't use when' routing blocks (#14521) 2026-02-18 01:28:20 +01:00
oracle chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
ordercli chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
peekaboo chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
sag chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
session-logs fix(skill): update session-logs paths from .clawdbot to .openclaw (#4502) 2026-02-01 11:42:28 -06:00
sherpa-onnx-tts fix(security): restrict skill download target paths 2026-02-16 03:47:28 +01:00
skill-creator chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
slack chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
songsee chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
sonoscli chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
spotify-player chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
summarize chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
things-mac chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
tmux feat(skills): Add 'Use when / Don't use when' routing blocks (#14521) 2026-02-18 01:28:20 +01:00
trello chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
video-frames chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
voice-call chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
wacli chore: Also format `scripts` and `skills`. 2026-01-31 21:21:25 +09:00
weather feat(skills): improve descriptions with routing logic (#14577) 2026-02-18 01:31:28 +01:00