docs(core): update README with new utilities and clarify agent skill management

README.md

@@ -46,14 +46,18 @@ into fish (`fish/conf.d/20-aliases.fish`) and bash/zsh
 (`~/.config/shell/aliases.sh`, sourced by `.bashrc`/`.zshrc`).
 
 Shell utilities live as standalone sh/bash executables in
-`~/.local/bin` (ai, c2p, fab, gdc, gho, ghn, ghg-clone, git-summary,
+`~/.local/bin` (ai, c2p, fab, gdc, ghn, ghg-clone, git-summary,
-mdp, mdcp, pj, …) so all shells share one implementation. Helpers that
+mdp, mdcp, mtime-sort, pj, …) so all shells share one implementation.
-must mutate shell state (`cd`-style: yy, c, cd, ghg/ghn/gho wrappers,
+Helpers that must mutate shell state (`cd`-style: yy, c, cd, ghg/ghn
-clip-last) are per-shell functions in `fish/functions/`,
+wrappers, gho, clip-last) are per-shell functions in `fish/functions/`,
 `bash/functions/`, and `zsh/functions/`.
 
-`~/.agents/skills` (agent skill library) is managed directly; the
+Agent skills are not vendored: `.chezmoidata/skills.yaml` lists every
-symlinks under `~/.claude/skills` resolve against it.
+skill and its upstream source, and
+`.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` installs them into
+`~/.agents/skills` (plus `~/.claude/skills` links) with the Skills CLI
+whenever that file changes, removing skills it installed earlier that are
+no longer listed.
 
 Linux desktop (role `desktop`/`laptop` only): niri, noctalia,
 fontconfig, mimeapps, systemd user units, niri-launch.