docs(install): update default skills path

Amolith created 3 weeks ago

Change default skills directory from ~/.config/crush/skills to
~/.config/agents/skills across Makefile and documentation. This makes the
path more generic and accommodates multiple agents that use this location
(Crush, Octofriend, Shelley, and Amp). Also adds documentation about tested
agents and updates the agent directories table to reflect current
configurations.

Assisted-by: GLM 4.7 via Crush <[e-mail]>

Change summary

Makefile  |  2 +-
README.md | 30 +++++++++++++++++++-----------
2 files changed, 20 insertions(+), 12 deletions(-)

Detailed changes

Makefile

@@ -1,4 +1,4 @@
-SKILL_DIR ?= $(HOME)/.config/crush/skills
+SKILL_DIR ?= $(HOME)/.config/agents/skills
 SKILLS := $(patsubst skills/%/,%,$(wildcard skills/*/))
 
 UNINSTALL_TARGETS := $(addprefix uninstall-,$(SKILLS))

README.md

@@ -13,7 +13,15 @@ agent capabilities through a standardised format.
 
 ## Available Skills
 
-Refer to [§ Token stats](#token-stats) for a detailed breakdown of each skill's token count, plus overall metadata usage.
+Refer to [§ Token stats](#token-stats) for a detailed breakdown of each skill's
+token count, plus overall metadata usage. I've used and tested them most with
+[Crush], [Amp], and [Shelley], and to a lesser degree, [Octofriend] and [Pi].
+
+[Crush]: https://github.com/charmbracelet/crush
+[Amp]: https://ampcode.com
+[Shelley]: https://github.com/boldsoftware/shelley
+[Octofriend]: https://github.com/synthetic-lab/octofriend
+[Pi]: https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent
 
 - [addressing-agent-comments](skills/addressing-agent-comments/SKILL.md): Finds
   `AGENT:` comments in code, gathers feedback, and carries out requested changes
@@ -83,7 +91,7 @@ cd agent-skills
 
 ### With Make
 
-Skills install to `~/.config/crush/skills/` by default. Override by
+Skills install to `~/.config/agents/skills/` by default. Override by
 setting `SKILL_DIR`. Tab completion works so you don't have to remember
 skill names or copy/paste.
 
@@ -108,23 +116,23 @@ make uninstall SKILL_DIR=$HOME/.codex/skills
 
 ```sh
 # Install all skills
-for s in skills/*/; do ln -s "$PWD/$s" ~/.config/crush/skills/; done
+for s in skills/*/; do ln -s "$PWD/$s" ~/.config/agents/skills/; done
 
 # Install specific skills
-ln -s "$PWD/skills/authoring-skills" ~/.config/crush/skills/
+ln -s "$PWD/skills/authoring-skills" ~/.config/agents/skills/
 
 # Remove a skill
-rm ~/.config/crush/skills/formatting-commits
+rm ~/.config/agents/skills/formatting-commits
 ```
 
 ### Agent skill directories
 
-| Agent                   | Dir                        |
-| ----------------------- | -------------------------- |
-| Crush                   | `~/.config/crush/skills/`  |
-| Amp                     | `~/.config/agents/skills/` |
-| Anthropic's Claude Code | `~/.claude/skills/`        |
-| OpenAI's Codex          | `~/.codex/skills/`         |
+| Agent                                   | Dir                        |
+| --------------------------------------- | -------------------------- |
+| [Crush], [Octofriend], [Shelley], [Amp] | `~/.config/agents/skills/` |
+| [Pi]                                    | `~/.pi/agent/skills/`      |
+| Anthropic's Claude Code                 | `~/.claude/skills/`        |
+| OpenAI's Codex                          | `~/.codex/skills/`         |
 
 ## Updating