alias-manager

Manage shell aliases in the .aliases file with conflict detection and category placement.

12|3|Updated Jun 5, 2017
One-click install
npx skills add https://github.com/ruchernchong/dotfiles --skill alias-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alias-manager
Source: https://github.com/ruchernchong/dotfiles/tree/main/.claude/skills/alias-manager
Command: npx skills add https://github.com/ruchernchong/dotfiles --skill alias-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually creating and managing shell aliases can lead to conflicts, incorrect syntax, or disorganised .aliases files, making shell customisation frustrating and inefficient. This Skill automates alias management for a perfectly tuned shell.

Core Features & Use Cases

  • Add Aliases: Checks for conflicts, verifies command validity, and adds new aliases to the correct category (e.g., Git, System, Development) with proper formatting and optional comments.
  • Remove & Update Aliases: Safely modifies or deletes existing alias definitions with user confirmation, ensuring your .aliases file remains clean and current.
  • Information & Search: Lists all defined aliases, searches by pattern, and explains what specific aliases do, helping you discover and understand your shell shortcuts.
  • Use Case: You frequently type git status. Use this Skill to create a new alias gs='git status' in the correct Git Aliases section of your .aliases file, instantly saving keystrokes and boosting your command-line productivity.

Quick Start

Create an alias 'gp' for 'git push'.

Frequently Asked Questions about alias-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create shell aliases to speed up frequently typed commands?

Shell aliases let you create shortcuts for long commands. This Skill manages aliases in your `.aliases` file by checking for conflicts, verifying syntax, and placing them in the correct category (Git, System, Development, Navigation, Utilities), so you can instantly save keystrokes without manual file editing or formatting errors.

Can I organize my bash and zsh aliases into categories?

Yes. This Skill enforces grouping into five predefined sections: Git, System, Development, Navigation, and Utilities. When you add or update aliases, they're automatically placed in the correct category with proper formatting and optional documentation, keeping your `.aliases` file organized and maintainable.

What happens if I try to create an alias that conflicts with an existing command?

This Skill detects conflicts before adding new aliases, preventing accidental overwrites or syntax errors. It checks your proposed alias against existing definitions and warns you, ensuring your shell shortcuts remain valid and don't break other commands or aliases.

How do I find and understand aliases I've already defined?

This Skill lets you search your aliases by pattern and lists all defined shortcuts with explanations. You can discover what aliases exist, understand what commands they run, and identify duplicates or unused shortcuts without manually parsing your `.aliases` file.

Can I safely remove or modify aliases without breaking my shell configuration?

Yes. This Skill handles removal and updates with user confirmation, ensuring changes don't leave syntax errors or orphaned references. It safely modifies or deletes alias definitions while preserving the rest of your `.aliases` file structure and grouping.

Do I need to understand shell escaping rules to add aliases with special characters?

No. This Skill enforces proper escaping automatically when you add aliases containing pipes, redirects, or other special shell characters. You provide the command, and it handles syntax validation and formatting, so aliases with complex arguments work correctly without manual escaping.