From 857a74b44b5ab2ccda63d59ce35070f55d1fd0bc Mon Sep 17 00:00:00 2001 From: Rajiv Shah Date: Fri, 28 Aug 2026 08:19:05 -0500 Subject: [PATCH 1/3] docs: explain skill name collisions Co-authored-by: openhands --- enterprise/skills-and-plugins.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/enterprise/skills-and-plugins.mdx b/enterprise/skills-and-plugins.mdx index 1ad5cce81..ebc9f2b39 100644 --- a/enterprise/skills-and-plugins.mdx +++ b/enterprise/skills-and-plugins.mdx @@ -231,6 +231,13 @@ a conversation created before the setting changed with a new conversation create is `.agents/skills//SKILL.md` and that the source control integration can clone the repository. + + Skill enablement is based on the skill name, not its source. Disabling a built-in skill also + disables a custom skill with the same `name` in its `SKILL.md` frontmatter. Give the custom + skill a unique name that matches its parent directory, such as `acme-github`. You can keep + `github` as a trigger if you want the renamed skill to activate for GitHub tasks. Enable the + renamed skill and start a new conversation. + Confirm that its trigger matches the user message or explicitly ask the agent to invoke the skill. Test with a unique trigger and exact expected behavior. From d485348314804d218a269242f853316c1cad58ca Mon Sep 17 00:00:00 2001 From: Rajiv Shah Date: Fri, 28 Aug 2026 08:27:38 -0500 Subject: [PATCH 2/3] docs: clarify custom skill triggers Co-authored-by: openhands --- enterprise/skills-and-plugins.mdx | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/enterprise/skills-and-plugins.mdx b/enterprise/skills-and-plugins.mdx index ebc9f2b39..7d4af6eb5 100644 --- a/enterprise/skills-and-plugins.mdx +++ b/enterprise/skills-and-plugins.mdx @@ -233,10 +233,11 @@ a conversation created before the setting changed with a new conversation create Skill enablement is based on the skill name, not its source. Disabling a built-in skill also - disables a custom skill with the same `name` in its `SKILL.md` frontmatter. Give the custom - skill a unique name that matches its parent directory, such as `acme-github`. You can keep - `github` as a trigger if you want the renamed skill to activate for GitHub tasks. Enable the - renamed skill and start a new conversation. + disables a custom skill with the same `name` in its `SKILL.md` frontmatter. Rename the custom + skill and its parent directory to a unique name, such as `acme-github`. Keep `github` in the + skill's `triggers` list so OpenHands applies the custom instructions when a request mentions + GitHub. In `Settings` > `Skills`, enable `acme-github`, then create a new conversation because + skill settings do not affect conversations that are already running. Confirm that its trigger matches the user message or explicitly ask the agent to invoke the From 4e0a2960ae6691d77dc872f68fa8d3553467548f Mon Sep 17 00:00:00 2001 From: Rajiv Shah Date: Fri, 28 Aug 2026 08:31:41 -0500 Subject: [PATCH 3/3] docs: shorten skill collision guidance Co-authored-by: openhands --- enterprise/skills-and-plugins.mdx | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/enterprise/skills-and-plugins.mdx b/enterprise/skills-and-plugins.mdx index 7d4af6eb5..907bb345b 100644 --- a/enterprise/skills-and-plugins.mdx +++ b/enterprise/skills-and-plugins.mdx @@ -233,11 +233,9 @@ a conversation created before the setting changed with a new conversation create Skill enablement is based on the skill name, not its source. Disabling a built-in skill also - disables a custom skill with the same `name` in its `SKILL.md` frontmatter. Rename the custom - skill and its parent directory to a unique name, such as `acme-github`. Keep `github` in the - skill's `triggers` list so OpenHands applies the custom instructions when a request mentions - GitHub. In `Settings` > `Skills`, enable `acme-github`, then create a new conversation because - skill settings do not affect conversations that are already running. + disables a custom skill with the same `name` in its `SKILL.md` frontmatter. A custom skill name + should not conflict with a built-in skill name. Rename the custom skill and its parent directory + to a unique name, such as `acme-github`. Confirm that its trigger matches the user message or explicitly ask the agent to invoke the