Awesome-Skills-Hub (ASH) 🚀

One skill library, every AI IDE — install once, sync to Cursor, Claude, Windsurf, and more.

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

English | 简体中文 | Contributing

📑 Table of Contents

• 🚀 Features
• 💡 Why ASH?
• 📦 Installation
• 📖 Usage Manual
• 🚀 Ecosystem Integration
• 📂 System Architecture
• 🤝 Supported Platforms
• 🛠️ Contributing

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.
• Ecosystem Integration: Auto-import skills downloaded via npx skills (See Ecosystem Integration).
• Smart Monorepo Discovery: Interactive UI to scan and install skills from complex repositories (e.g., huggingface/skills).
• Meta-Skill (Self-Discovery): Empower your Agent to autonomously search and install the skills it needs (ash search -> ash add).

💡 Why ASH? (The "Bridge" Philosophy)

Unlike other tools that just download static skill content (Repository) or try to convert formats (Loader), ASH acts as a physical Bridge.

📦 Installation

1. Zero-Install (Try it out)

Run instantly without installing anything:

💡 Pro Tip: You can use the short alias npx askill instead of npx awesome-skills-hub.

# 1. Browse Skill Library
npx askill list

# 2. Install a Skill (Auto-initializes & syncs to IDEs)
npx askill 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 askill

# 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 (Supported):

# One-line install (requires Git)
irm https://raw.githubusercontent.com/tiandee/awesome-skills-hub/main/install.ps1 | iex
# Reload profile to use ash
. $PROFILE

4. Manual Install (Clone)

If you want to contribute code:

macOS / Linux:

# Run installer
bash install.sh

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

Windows:

# From project root after clone
.\install.ps1
# Reload profile
. $PROFILE

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 add pdf               # Install by name (Global)
ash add --all             # Sync all 17+ skills to all IDEs at once

4. Project Mode (Local Install) 🆕 (Aliases: add, install)

Install a skill (e.g., ash add expert) directly into your Current Project Directory. ASH enforces .claude/skills consistency but automatically bridges to your IDE.

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

Supported IDE Bridges:

5. CLI Command Reference 🆕

🚀 Ecosystem Integration

ASH can automatically detect and import skills from the Vercel ecosystem. Vercel's official npx skills tool downloads skills to ~/.agents/skills. ASH can scan this directory and instantly bridge those high-quality skills to all your IDEs.

1. Download: Use Vercel's tool to grab a skill:
   hljs language-bash

   Copy

   npx skills add user/repo
   

2. Sync: Let ASH take over and distribute:
   hljs language-bash

   Copy

   ash sync
   

   (ASH will prompt you about the new skills found. Once confirmed, they are available in Cursor, Windsurf, etc.)

💡 Recommended Resources

Looking for high-quality skills? Check out Skill Hub CN. It curates excellent skills, such as the official Anthropic Frontend Design skill:

# Example: Install Anthropic's frontend-design skill
npx skills add https://github.com/anthropics/skills --skill frontend-design

# Let ASH distribute it
ash sync

6. Search & Status

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

7. Clean & Reset

Instantly clear skill links.

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

8. Uninstall

Remove specific symlinks.

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

9. Sync Skills

Pull latest skills to Global Home.

ash sync

10. CLI Maintenance

Manage the tool itself.

# Upgrade to the latest version
npm update -g askill

# Check current installed version
npm list -g askill

# Check latest available version on NPM
npm view askill version

# Uninstall CLI tool
npm uninstall -g askill

📂 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