diff --git a/enterprise/skills-and-plugins.mdx b/enterprise/skills-and-plugins.mdx
index 1ad5cce8..907bb345 100644
--- a/enterprise/skills-and-plugins.mdx
+++ b/enterprise/skills-and-plugins.mdx
@@ -231,6 +231,12 @@ a conversation created before the setting changed with a new conversation create
     is `.agents/skills/<name>/SKILL.md` and that the source control integration can clone the
     repository.
   </Accordion>
+  <Accordion title="A Custom Skill Has the Same Name as a Built-In Skill">
+    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. 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`.
+  </Accordion>
   <Accordion title="A Skill Appears but Does Not Affect the 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.