From 14deb6baf7cf9ccec3c87991bc0219991dc8065d Mon Sep 17 00:00:00 2001 From: Kit Langton Date: Tue, 11 Aug 2026 16:46:14 -0400 Subject: [PATCH] docs: clarify skill source precedence (#41844) --- packages/www/content/docs/(Configure)/skills.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/www/content/docs/(Configure)/skills.mdx b/packages/www/content/docs/(Configure)/skills.mdx index 8339e394362..8b60bc68aae 100644 --- a/packages/www/content/docs/(Configure)/skills.mdx +++ b/packages/www/content/docs/(Configure)/skills.mdx @@ -161,8 +161,8 @@ Skills are keyed by ID. If several sources define the same ID, the later source wins. Sources are registered in this order, from lower to higher precedence: 1. Built-in skills -2. `.claude/skills` sources, global first and then from the current directory upward -3. `.agents/skills` sources, global first and then from the current directory upward +2. `.claude/skills` sources, global first and then from the farthest ancestor toward the current directory +3. `.agents/skills` sources, global first and then from the farthest ancestor toward the current directory 4. `~/.config/opencode/skills` 5. Project `.opencode/skills`, from the project root toward the current directory 6. Explicit `skills` config entries, in config priority and array order