@@ -388,11 +388,23 @@ extending agent capabilities with reusable skill packages. Skills are folders
388containing a `SKILL.md` file with instructions that Crush can discover and
388containing a `SKILL.md` file with instructions that Crush can discover and
389activate on demand.
389activate on demand.
391−Skills are discovered from:
391+The global paths we looks for skills are:
393−- `~/.config/crush/skills/` on Unix (default, can be overridden with `CRUSH_SKILLS_DIR`)
393+* `$CRUSH_SKILLS_DIR`
394−- `%LOCALAPPDATA%\crush\skills\` on Windows (default, can be overridden with `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\`
395−- Additional paths configured via `options.skills_paths`
399+* Additional paths configured via `options.skills_paths`
401+On top of that, we _also_ load skills in your project from the following