Skip to content

docs: explain custom skill name collisions #766

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rajshah4 merged 3 commits into from
Aug 28, 2026
+6 −0
Merged

docs: explain custom skill name collisions #766

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
857a74b
docs: explain skill name collisions
rajshah4 Aug 28, 2026
d485348
docs: clarify custom skill triggers
rajshah4 Aug 28, 2026
4e0a296
docs: shorten skill collision guidance
rajshah4 Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions enterprise/skills-and-plugins.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@
The plugin is loaded only into the new conversation.
</Tab>
<Tab title="Launch Link">
Use the `/launch` route to share a preconfigured plugin:

Check warning on line 143 in enterprise/skills-and-plugins.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/skills-and-plugins.mdx#L143 

Did you really mean 'preconfigured'?

```text
https://app.<your-base-domain>/launch?plugins=<base64-encoded-plugin-array>
Expand Down Expand Up @@ -231,6 +231,12 @@
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

Check warning on line 235 in enterprise/skills-and-plugins.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/skills-and-plugins.mdx#L235 

Did you really mean 'enablement'?
disables a custom skill with the same `name` in its `SKILL.md` frontmatter. A custom skill name

Check warning on line 236 in enterprise/skills-and-plugins.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/skills-and-plugins.mdx#L236 

Did you really mean 'frontmatter'?
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.
Expand Down
Loading