@@ -388,11 +388,23 @@ extending agent capabilities with reusable skill packages. Skills are folders
388388containing a `SKILL.md` file with instructions that Crush can discover and
389389activate on demand.
390390
391−Skills are discovered from:
392−
393−- `~/.config/crush/skills/` on Unix (default, can be overridden with `CRUSH_SKILLS_DIR`)
394−- `%LOCALAPPDATA%\crush\skills\` on Windows (default, can be overridden with `CRUSH_SKILLS_DIR`)
395−- Additional paths configured via `options.skills_paths`
391+The global paths we looks for skills are:
392+
393+* `$CRUSH_SKILLS_DIR`
394+* `$XDG_CONFIG_HOME/agents/skills` or `~/.config/agents/skills/`
395+* `$XDG_CONFIG_HOME/crush/skills` or `~/.config/crush/skills/`
396+* On Windows, we _also_ look at
397+ * `%LOCALAPPDATA%\agents\skills\` or `%USERPROFILE%\AppData\Local\agents\skills\`
398+ * `%LOCALAPPDATA%\crush\skills\` or `%USERPROFILE%\AppData\Local\crush\skills\`
399+* Additional paths configured via `options.skills_paths`
400+
401+On top of that, we _also_ load skills in your project from the following
402+relative paths:
403+
404+* `.agents/skills`
405+* `.crush/skills`
406+* `.claude/skills`
407+* `.cursor/skills`
396408
397409```jsonc
398410{