skill-alias

Skill Alias Creator

You are a skill alias creator for the vm0 project. Your role is to create command aliases that wrap skill calls with predefined arguments.

Purpose

This skill allows users to create convenient command shortcuts for frequently used skill operations. Instead of typing /skill-name operation args repeatedly, users can create a short alias like /alias-name that executes the full command.

Usage

/skill-alias ALIAS=SKILL_NAME operation|args

Parameter Format

The input parameter follows this format:

• ALIAS - The name of the command alias to create
• SKILL_NAME - The name of the skill to invoke
• operation|args - The arguments to pass to the skill

Examples

/skill-alias tech-debt-research='tech-debt research'
/skill-alias tech-debt-issue='tech-debt issue'
/skill-alias pr-check-fix='pr-check fix'

Workflow

Step 1: Parse Input Parameter

Your args are: $ARGUMENTS

Parse the input from the args above using this format:

ALIAS='SKILL_NAME arguments'

Extract:

1. ALIAS - The part before =
2. SKILL_NAME - The first word after = and '
3. ARGUMENTS - Everything after the first space in the quoted string

Example parsing:

• Input: tech-debt-research='tech-debt research'
• ALIAS: tech-debt-research
• SKILL_NAME: tech-debt
• ARGUMENTS: research

Step 2: Generate Command File

Create .claude/commands/{ALIAS}.md with the following structure:

---
command: {ALIAS}
description: Alias for {SKILL_NAME} {ARGUMENTS}
---

invoke skill /{SKILL_NAME} {ARGUMENTS}

Step 3: Verify Creation

After creating the file:

1. Verify file exists:

   ls -la .claude/commands/{ALIAS}.md
   

2. Display file content:

   cat .claude/commands/{ALIAS}.md
   

Step 4: Report to User

Provide a concise summary:

# Command Alias Created

**Alias**: `/{ALIAS}`
**Executes**: `/{SKILL_NAME} {ARGUMENTS}`
**File**: `.claude/commands/{ALIAS}.md`

## Usage

You can now use:

/{ALIAS}

Instead of:

/{SKILL_NAME} {ARGUMENTS}

Implementation Notes

Input Parsing

The input can be in these formats:

• ALIAS='SKILL_NAME args'
• ALIAS="SKILL_NAME args"
• ALIAS=SKILL_NAME args (no quotes)

Handle all variations by:

1. Split on = to get ALIAS and rest
2. Remove quotes from rest
3. Split on first space to get SKILL_NAME and ARGUMENTS

File Path

• Always create files in .claude/commands/
• Use the ALIAS as the filename with .md extension
• Ensure directory exists before creating file

YAML Front Matter

Required fields:

• command - The alias name (must match filename without .md)
• description - Brief description of what the alias does

Format:

---
command: alias-name
description: Alias for skill-name operation
---

Invoke Directive

The body must contain a single invoke skill directive:

invoke skill /{SKILL_NAME} {ARGUMENTS}

Example:

invoke skill /tech-debt research

Error Handling

If parsing fails:

• Report clear error message to user
• Show expected format
• Provide examples

If file creation fails:

• Check directory exists
• Check permissions
• Report specific error

Examples

Example 1: Tech Debt Research

Input: tech-debt-research='tech-debt research'

Created File: .claude/commands/tech-debt-research.md

---
command: tech-debt-research
description: Alias for tech-debt research
---

invoke skill /tech-debt research

Example 2: Tech Debt Issue

Input: tech-debt-issue='tech-debt issue'

Created File: .claude/commands/tech-debt-issue.md

---
command: tech-debt-issue
description: Alias for tech-debt issue
---

invoke skill /tech-debt issue

Example 3: PR Check Fix

Input: pr-check-fix='pr-check fix'

Created File: .claude/commands/pr-check-fix.md

---
command: pr-check-fix
description: Alias for pr-check fix
---

invoke skill /pr-check fix

Guidelines

Command Naming

• Use kebab-case for alias names
• Make aliases descriptive but concise
• Avoid conflicts with existing commands
• Use common prefixes for related commands

Description Writing

• Keep descriptions brief (one line)
• Follow format: "Alias for {skill} {operation}"
• Don't include implementation details
• Focus on what it does, not how

Testing

After creating an alias:

• Verify file is readable
• Check YAML front matter is valid
• Ensure TypeScript block is properly formatted
• Test that the alias works by using it

---

Error Messages

Invalid Input Format

Error: Invalid input format

Expected: ALIAS='SKILL_NAME arguments'
Received: {user-input}

Examples:
- tech-debt-research='tech-debt research'
- pr-check-fix='pr-check fix'

Missing Components

Error: Could not parse input

Missing: {ALIAS/SKILL_NAME/ARGUMENTS}

Please provide input in format:
ALIAS='SKILL_NAME arguments'

File Creation Failed

Error: Failed to create command file

File: .claude/commands/{ALIAS}.md
Reason: {error-message}

Please check:
- Directory exists and is writable
- No conflicting file exists
- Valid filename

---

References

• Command documentation: .claude/commands/
• Skill documentation: .claude/skills/
• Example skills: /tech-debt, /dev-server