Skill Aliasing

VerifiedSafe

How to create a skill alias using a stub SKILL.md with a description pointing to the real skill.

Sby Skills Guide Bot
DevelopmentBeginner
107/25/2026
Claude Code
#aliasing#skills#configuration#claude-code

Recommended for

Our review

Creates an alias to an existing skill by placing a minimal SKILL.md file whose description routes to the real skill.

Strengths

  • Extremely simple to implement
  • No symlinks or complex redirect logic needed
  • Works with the existing skill listing mechanism

Limitations

  • Does not validate that the target skill exists
  • Alias is static – requires manual update if target changes
  • Can be confusing if description is not maintained
When to use it

Use this approach when you want to expose a skill under a different or shorter name without duplicating its contents.

When not to use it

Avoid it if you need conditional logic or transformation between the alias and the real skill – instead, use an explicit redirect script.

Security analysis

Safe
Quality score70/100

The skill only documents a pattern for creating aliases; the git show command is read-only and safe, with no destructive or exfiltration risk.

No concerns found

Examples

Create an alias for a skill
I want to create an alias '/shortcut' that points to the existing skill '/very-long-skill-name'. Please create a SKILL.md file with an empty body and set description to 'alias for /very-long-skill-name'.

description: How to alias a skill — a 5-line stub SKILL.md whose description says "alias for /<real-skill>". Shown via the commit that added /wt.

Aliasing a skill

Drop a SKILL.md with empty body; the description line tells future-you (Claude) to call the real skill:

!git show e072fa0b784f5b79e9fbca932c7ade3cdf71225b

That's it. No symlink, no redirect logic — the harness lists the alias by name, the description routes the call.

Related skills