Awesome-Skills-Hub (ASH)

"Write Once, Link Everywhere" - The "Homebrew" for AI IDE Skills.

Awesome-Skills-Hub (ASH) 🚀

A lightweight package manager for AI IDE skills, rules, and architecture instructions.

English | 简体中文

Awesome-Skills-Hub (ASH) is a lightweight package manager designed to unify the management of AI Skills (Prompts, Rules, Instructions) across different AI coding environments.

Instead of copying and pasting your favorite "Expert Java Developer" prompt into Antigravity, Cursor, Windsurf, and Claude separately, ash lets you maintain a single "Source of Truth" in this repository and symlink it to all your tools instantly.

🚀 Features

• Dual-Scope Management: Support both Global Scope (~/.ash/skills) and Project Scope (Project-local).
• Universal IDE Bridge: Automatically compatibilizes with Cursor, Windsurf, TRAE, Antigravity, and **Copilot).
• Centralized "Homebrew": Keep all your prompts in one place, independent of IDE configs.
• Live Symlinks: Updates in the repository immediately reflect in all your connected IDEs.
• Smart Interaction: Name-based installation, batch operations, and "Did you mean?" suggestions.

📦 Installation

1. Zero-Install (Try it out)

Run instantly without installing anything:

# 1. Browse Skill Library
npx awesome-skills-hub list

# 2. Install a Skill (Auto-initializes & syncs to IDEs)
npx awesome-skills-hub install pdf

💡 Pro Tip: Zero-Install mode is primarily for trying Built-in Skills. To manage your full library (including adding custom skills) and unlock offline speed, please use Quick Install.

2. Quick Install (Recommended)

Via NPM (Cross-Platform):

# 1. Install globally (Unlocks the 'ash' command)
npm install -g awesome-skills-hub

# 2. Initialize environment (Detects IDEs & creates ~/.ash)
ash init

# 3. Verify installation (List available skills)
ash list

3. Alternative Install (Shell Script)

If you don't have Node.js installed:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/tiandee/awesome-skills-hub/main/install.sh | bash

Windows (Pending Adaptation):

Please use WSL for development and contribution for now.

# (Coming Soon)
# .\install.ps1
# . $PROFILE

4. Manual Install (Clone)

If you prefer managing the repo yourself:

macOS / Linux:

# Run installer
bash install.sh

# Reload shell config
source ~/.zshrc  # or ~/.bashrc

The installer will:

1. Detect and initialize all mainstream AI IDE environments.
2. Setup ASH_HOME: Create ~/.ash/skills (or ~\.ash\skills on Windows) for persistent storage.
3. Configure environment variables for Zsh, Bash, and Fish.
4. Enable global ash command access instantly.

📖 Usage Manual

1. Browse Skill Library

Browse official Anthropic skills:

ash list

2. View Skill Details

Get detailed descriptions, triggers, and content previews:

ash info pdf       # Supports smart name matching

3. Install a Skill (Global / User Level)

Link a skill to your User Home Directory (~/.ash/skills).

ash install pdf           # Install by name (Global)
ash install --all         # Sync all 17+ skills to all IDEs at once

4. Project Mode (Local Install) 🆕

Install skills directly into your Current Project Directory. ASH enforces .claude/skills consistency but automatically bridges to your IDE.

cd my-project
ash install java -p              # Install to ./.claude/skills
ash install --all -p             # Install ALL skills to project

Supported IDE Bridges:

5. Search & Status

ash search web            # Keyword search
ash status                # Check current installation map

6. Clean & Reset

Instantly clear skill links.

ash clean cursor          # Clear Cursor skills only
ash clean --all           # Clear ALL IDE skills

7. Uninstall

Remove specific symlinks.

ash uninstall pdf         # Uninstall specific skill
ash uninstall --all       # (Same as clean --all)

8. Sync Skills

Pull latest skills to Global Home.

ash sync

9. CLI Maintenance

Manage the tool itself.

# Upgrade to the latest version
npm update -g awesome-skills-hub

# Check current installed version
npm list -g awesome-skills-hub

# Check latest available version on NPM
npm view awesome-skills-hub version

# Uninstall CLI tool
npm uninstall -g awesome-skills-hub

📂 System Architecture

• ASH Home: ~/.ash (or $env:USERPROFILE\.ash)
• Global Skills Hub: ~/.ash/skills/
• Persistent Links: All IDE symlinks point to this stable global path.

🧩 UX Highlights

• Smart Suggestions: Type a typo (e.g., ash intall) and get a "Did you mean?" hint.
• Transparent Feedback: Detailed IDE-level reports for batch operations.

🤝 Supported Platforms

| Platform | Target Path | Status | | :--- | :--- | :--- | | | ~/.agent/skills/ | ✅ | | | ~/.cursor/skills/ | ✅ | | | ~/.trae/skills/ | ✅ | | | ~/.windsurf/skills/ | ✅ | | | ~/.copilot/skills/ | ✅ | | | ~/.claude/skills/ | ✅ |

🛠️ Contributing

Got a killer prompt or a useful rule? We'd love to have it!

1. Fork the repository.
2. Create your skill directory in skills/<name>/.
3. Add SKILL.md (content) and optional scripts/.
4. Submit a Pull Request.

📄 License

MIT © Tiandee