From 3361953fe1fe5dceacc77ed0483db909ec90882e Mon Sep 17 00:00:00 2001 From: Aiden Cline <63023139+rekram1-node@users.noreply.github.com> Date: Fri, 18 Sep 2026 20:32:36 -0500 Subject: [PATCH] fix(core): explain user-invoked skills in skill guidance (#49871) --- packages/core/src/skill/instructions.ts | 1 + packages/core/test/skill/instructions.test.ts | 1 + 2 files changed, 2 insertions(+) diff --git a/packages/core/src/skill/instructions.ts b/packages/core/src/skill/instructions.ts index 2cac66a4454..241e8f80150 100644 --- a/packages/core/src/skill/instructions.ts +++ b/packages/core/src/skill/instructions.ts @@ -26,6 +26,7 @@ const render = (skills: ReadonlyArray) => [ "Skills provide specialized instructions and workflows for specific tasks.", "Use the skill tool to load a skill when a task matches its description.", + "The user may also invoke a skill directly. When that happens, its instructions appear in the conversation as a block, the same shape the skill tool returns. A skill that is already present this way does not need to be invoked again.", ...(skills.length === 0 ? ["No skills are currently available."] : ["", ...entries(skills), ""]), diff --git a/packages/core/test/skill/instructions.test.ts b/packages/core/test/skill/instructions.test.ts index 64f263ae645..d13fc771fff 100644 --- a/packages/core/test/skill/instructions.test.ts +++ b/packages/core/test/skill/instructions.test.ts @@ -59,6 +59,7 @@ describe("SkillInstructions", () => { [ "Skills provide specialized instructions and workflows for specific tasks.", "Use the skill tool to load a skill when a task matches its description.", + "The user may also invoke a skill directly. When that happens, its instructions appear in the conversation as a block, the same shape the skill tool returns. A skill that is already present this way does not need to be invoked again.", "", " ", " effect",