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
7/25/2026
Claude Code
#aliasing#skills#configuration#claude-code

Recommended for

Automated summary

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

How this analysis is made

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.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/skill-aliasing-mrzxuro2/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/skill-aliasing-mrzxuro2' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/skill-aliasing-mrzxuro2/download' --output '.skill-downloads/skill-aliasing-mrzxuro2/SKILL.md.part' && mv '.skill-downloads/skill-aliasing-mrzxuro2/SKILL.md.part' '.skill-downloads/skill-aliasing-mrzxuro2/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/skill-aliasing-mrzxuro2/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills