diff --git a/Makefile b/Makefile
index f5e280b6efbc05d06e4e0cd31574661ee80f095e..2d00b5c0d60862081764a0f41f3b9294f2098d1e 100644
--- a/Makefile
+++ b/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))
diff --git a/README.md b/README.md
index 1507a287885581120fd49ff2e5cb788e9aa32421..ab5f044f321d07ffd679982f467411a2f7053fa2 100644
--- a/README.md
+++ b/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