From aca5326abab9f169a1d5d44f6a3a604c2e83e67f Mon Sep 17 00:00:00 2001 From: Kevin Glynn Date: Wed, 15 Jul 2026 01:46:16 -0400 Subject: [PATCH] docs(skill-anatomy): reword rule of thumb to current convention per review --- docs/skill-anatomy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/skill-anatomy.md b/docs/skill-anatomy.md index 32f67444..2a1ca86f 100644 --- a/docs/skill-anatomy.md +++ b/docs/skill-anatomy.md @@ -115,7 +115,7 @@ This is a pack-level design choice. The Agent Skills spec describes a skill as a The tradeoff is portability: a whole-repo install (such as the Claude Code marketplace plugin) carries `references/` along, but a per-skill install that copies only `skills//` leaves the repo-root sibling behind, and those links resolve to nothing. That gap is tracked in [#361](https://github.com/addyosmani/agent-skills/issues/361). -Rule of thumb: material used by exactly one skill is a supporting file inside that skill's directory; material shared across skills goes in `references/`. +Current convention: material used by exactly one skill is a supporting file inside that skill's directory; material shared across skills goes in `references/`. ## Context Efficiency