@supertiny99/easy-skill

easy-skill

🛠️ TUI tool for managing skills - download, organize and create symlinks for .claude and .trae.

✨ Features

• 📥 Smart Download - Auto-detect branches and skill candidates from Git repos
• 🔍 Repository Explorer - Browse and multi-select skills from any repo
• 🔗 Batch Link/Unlink - Manage symlinks across multiple IDEs at once
• 📋 Status Overview - View all skills and their link status
• ⚡ Quick Actions - Toggle all, rename conflicts, skip duplicates

🚀 Installation

npm install -g @supertiny99/easy-skill

📖 Usage

Interactive TUI (Recommended)

easy-skill
# or short alias
es

TUI Flow

1. Select action (Download / Link / Unlink / List / Remove)
2. For Git downloads:
   - Enter repository URL
   - Select branch from list
   - Multi-select skills to download ([space] select, [a] toggle all)
   - Handle conflicts (overwrite/rename/skip/reselect)
   - Multi-select IDEs to create symlinks

CLI Commands

# Download from Git (with smart explore)
easy-skill download https://github.com/user/skills.git

# Download with options
easy-skill download https://github.com/user/skills.git \
  --branch main \
  --subdir my-skill \
  --id custom-name \
  --link

# Link/Unlink skills
easy-skill link my-skill --claude --trae
easy-skill unlink my-skill

# List all skills
easy-skill list  # or: es ls

# Remove skill
easy-skill remove my-skill  # or: es rm my-skill --force

📁 Directory Structure

your-project/
├── skills/                    # Downloaded skills
│   ├── skill-1/
│   └── skill-2/
├── .claude/skills/            # Claude symlinks
│   ├── skill-1 -> ../../skills/skill-1
│   └── skill-2 -> ../../skills/skill-2
└── .trae/skills/              # Trae symlinks
    ├── skill-1 -> ../../skills/skill-1
    └── skill-2 -> ../../skills/skill-2

🎯 Supported IDEs

IDE	Skill Directory
🤖 Claude	.claude/skills/
🚀 Trae	.trae/skills/

🔧 Development

# Clone and install
git clone https://github.com/supertiny99/easy-skill.git
cd easy-skill
npm install

# Build and link globally
npm run build
npm link

# Run in dev mode
npm run dev

📦 Release

# Patch release (1.0.0 -> 1.0.1)
npm run release:patch

# Minor release (1.0.0 -> 1.1.0)
npm run release:minor

# Major release (1.0.0 -> 2.0.0)
npm run release:major

📄 License

MIT © supertiny99