Feature: skill aliases in SKILL.md frontmatter
Problem
Custom skills can only be invoked by their exact directory/frontmatter name (e.g., /skaile-dev-git). When skills use namespace prefixes for disambiguation (common in plugins), the full name becomes tedious to type repeatedly.
Proposed Solution
Support an aliases array in the SKILL.md YAML frontmatter:
---
name: skaile-dev-git
description: Git operations for skaile-dev
aliases: [git, dev-git]
---
This would register /git and /dev-git as additional invocation paths that resolve to the same skill. The canonical name remains skaile-dev-git for display and conflict resolution.
Conflict Resolution
If two skills register the same alias, the Skill tool could:
- Prefer the skill installed closest to the project (project > user > plugin)
- Warn on ambiguity and prompt the user to use the full name
Alternatives Considered
- Wrapper skills: Creating a thin
/gitskill that delegates to/skaile-dev-git. Works but doubles the number of registered skills and adds maintenance overhead. - Renaming: Dropping the namespace prefix. Loses disambiguation for multi-plugin setups.
- settings.json alias map: A separate
skillAliasesconfig. Works but scatters the alias definition away from the skill itself.
Use Case
We maintain ~15 custom skills with a skaile-dev- prefix. The most frequently used ones (git, test, implement, docs) would benefit from short aliases while keeping the full name for clarity in listings and logs.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗