✨ What it does

Clones the top community skills from GitHub and wires them into every AI agent on your machine — automatically.

skill-blast installs 50 skills across 9 categories:

  🎨 UI/Design    ·  9 skills  (frontend-design, canvas-design, color-expert…)
  📱 Content      · 10 skills  (social-media-os, voice-builder, reels-scripting…)
  ✍️  Writing      ·  2 skills  (humanizer, beautiful-prose)
  🔬 Research     ·  5 skills  (deep-research, academic-research, daydream…)
  📈 Marketing    ·  7 skills  (marketing-module, geo-seo, email-bible…)
  🗂️  Product      ·  3 skills  (pm-skills, jtbd-interview, ai-transformation)
  ⚙️  Engineering  ·  8 skills  (superpowers, repomix, antfu-skills…)
  🎬 Media        ·  4 skills  (remotion, ai-video-toolkit, ai-music…)
  🏥 Health       ·  2 skills  (personal-health, dna-analysis)

🖥️ Supported agents

📦 Installation

🟢 Easiest — pip (all platforms)

pip install skill-blast
skill-blast

🐧 Linux / macOS — one-liner

curl -fsSL https://raw.githubusercontent.com/Venkatesh-6921/skill-blast/main/install.sh | bash

Or with wget:

wget -qO- https://raw.githubusercontent.com/Venkatesh-6921/skill-blast/main/install.sh | bash

🪟 Windows — PowerShell

irm https://raw.githubusercontent.com/Venkatesh-6921/skill-blast/main/install.ps1 | iex

🪟 Windows — Double-click

1. Download install.bat
2. Double-click it
3. Follow the prompts

🐍 From source

git clone https://github.com/Venkatesh-6921/skill-blast
cd skill-blast
pip install -e .
skill-blast

Requirements: Python 3.9+ and git. That's it.

🧙 Usage

Interactive wizard (recommended for beginners)

Just run with no arguments and follow the prompts:

skill-blast

Step 1 of 3 — Which AI agents do you use?

  Detected on your machine:
    ✓ 🤖 Claude Code
    ✓ ⚡ OpenCode

  All available agents:
    1. 🤖 Claude Code       detected
    2. ⚡ OpenCode          detected
    3. 🚀 Antigravity       not detected
    ...

  Your choice [1,2]:

Developer — flags

# Install everything to auto-detected agents
skill-blast --all

# Target specific agents
skill-blast --agents claude-code opencode antigravity

# Install only specific categories
skill-blast --only Engineering "UI/Design" Research

# Skip specific skill IDs
skill-blast --skip 49 50

# Preview without writing any files
skill-blast --dry-run

# Pull latest for already-installed skills
skill-blast --update

# List all 50 skills
skill-blast --list

# List only one category
skill-blast --list --only Marketing

# Install to all agents even if not detected
skill-blast --force-agents

# Install specific skills by ID from GitHub (with sub-agent & multi-agent support)
skill-blast --github-install 1 41

# Install from GitHub to specific agents only
skill-blast --github-install 2 --agents claude-code opencode

# View installed skills from the local registry
skill-blast --status

📋 All 50 Skills

🗂️ How it works

skill-blast
    │
    ├── 1. Clone each unique GitHub repo → ~/.skill-blast/cache/
    │         (one clone per repo, shared across all agents)
    │
    ├── 2. Copy skill directory → ~/.skill-blast/skills/<name>/
    │         (sparse copy for subdirectory skills)
    │
    └── 3. Symlink → each agent's skills directory
              ~/.claude/skills/<name>     → ~/.skill-blast/skills/<name>
              ~/.opencode/skills/<name>   → ~/.skill-blast/skills/<name>
              ...

• Efficient: Each GitHub repo is cloned once, no matter how many skills use it
• Non-destructive: Existing skills are never overwritten
• Cross-platform: Uses symlinks on Linux/macOS, directory copies on Windows
• Cached: Re-running is instant for already-cloned repos

🔄 Updating skills

skill-blast --update

Pulls git pull on every cached repo and refreshes your skill store.

🛠️ Management commands

# Check version
skill-blast --version

# Uninstall all skills
skill-blast --uninstall

# Uninstall only Media skills
skill-blast --uninstall --only Media

# Health diagnostics — broken symlinks, cache status, git connectivity
skill-blast --check

# Show detailed metadata about a specific skill
skill-blast --info 1

# View all installed skills with agent and timestamp info
skill-blast --status

# Install a specific skill by ID from GitHub (auto-detects agents + sub-agents)
skill-blast --github-install 1

❓ Troubleshooting

sudo chown -R $(whoami) ~/.claude ~/.opencode ~/.gemini

# Check manually:
git clone https://github.com/owner/repo --depth=1

# Skip that skill:
skill-blast --skip <ID>

# Diagnose:
skill-blast --check

# Repair — re-clones and re-links:
skill-blast --update

🤝 Contributing

PRs welcome! To add a new skill:

1. Add an entry to skill_blast/skills.py
2. Test with skill-blast --dry-run --only YourCategory
3. Open a PR

See CONTRIBUTING.md for full guidelines.

📄 License

MIT — see LICENSE