Feature: skill aliases in SKILL.md frontmatter

Resolved 💬 3 comments Opened Apr 28, 2026 by peteralbert Closed Jun 30, 2026

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 /git skill 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 skillAliases config. 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.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗