From deec350fe158e4b38b20042a60ea698a5a284fff Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Wed, 4 Feb 2026 10:31:52 -0700
Subject: [PATCH] docs(install): update default skills path

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 <crush@charm.land>
---
 Makefile  |  2 +-
 README.md | 30 +++++++++++++++++++-----------
 2 files changed, 20 insertions(+), 12 deletions(-)

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