cli-ai-skills v1.7.2

🚀 NPX Installer for AI Skills

Install reusable skills for GitHub Copilot CLI, Claude Code, OpenAI Codex, OpenCode, and Gemini CLI in one command.

🚀 Quick Start

Shell installer (recommended):

curl -fsSL https://raw.githubusercontent.com/ericandrade/cli-ai-skills/main/scripts/install.sh | bash

Or use NPX:

# Zero-config installation (interactive)
npx cli-ai-skills

# Auto-install all platforms (skip prompts)
npx cli-ai-skills -y -q

# Install specific bundle
npx cli-ai-skills --bundle essential -y

See Installation Guide for all methods.

📦 What It Does

1. 🔍 Detects installed AI CLI tools (Copilot, Claude, Codex, OpenCode, Gemini)
2. 📋 Lists all 4 available AI skills
3. ⚙️ Installs skills to the correct platform directories
4. ✅ Validates installation success

⚡ Command Shortcuts

| Shortcut | Full Form | Purpose | |----------|-----------|---------| | i | install | Install skills (default) | | ls | list | List installed skills | | up | update | Update skills | | rm | uninstall | Remove skills | | doc | doctor | Check installation |

Examples:

npx cli-ai-skills i -y       # Install with confirmation skip
npx cli-ai-skills ls -q      # List quietly
npx cli-ai-skills up         # Check for updates

🚩 Short Flags

| Flag | Full Form | Purpose | |------|-----------|---------| | -a | --all | Operate on all platforms | | -g | --global | Global installation | | -l | --local | Local installation | | -y | --yes | Skip all prompts | | -q | --quiet | Minimal output |

Combine flags:

npx cli-ai-skills i -a -y -q    # Install all, skip prompts, quiet

📦 Curated Bundles

Instead of installing everything, choose a bundle:

# Essential (skill-creator, prompt-engineer)
npx cli-ai-skills --bundle essential -y

# Content (youtube-summarizer, audio-transcriber)
npx cli-ai-skills --bundle content -y

# Developer (skill-creator)
npx cli-ai-skills --bundle developer -y

# All (complete toolkit)
npx cli-ai-skills --bundle all -y

See all bundles:

npx cli-ai-skills --list-bundles

🔍 Search Skills

Find skills by keyword:

npx cli-ai-skills --search "prompt"
npx cli-ai-skills --search "video"
npx cli-ai-skills --search "transcription"

💻 Supported Platforms

• GitHub Copilot CLI (~/.copilot/skills/)
• Claude Code (~/.claude/skills/)
• OpenAI Codex (~/.codex/skills/)

📚 Available Skills

All 4 skills are universal and work on all platforms:

1. skill-creator (v1.3.0) - Create custom skills
2. prompt-engineer (v1.1.0) - Optimize prompts
3. youtube-summarizer (v1.2.0) - Summarize videos
4. audio-transcriber (v1.2.0) - Transcribe audio

🔧 Installation Methods

Method 1: NPX (Easiest - Recommended)

# One-time use (always latest)
npx cli-ai-skills

# Or install globally
npm install -g cli-ai-skills
cli-ai-skills

Method 2: From Source

git clone https://github.com/ericgandrade/cli-ai-skills.git
cd cli-ai-skills/cli-installer
npm link
cli-ai-skills

📖 Command Reference

install / i

Install AI skills to selected platforms.

npx cli-ai-skills install                  # Interactive
npx cli-ai-skills i -a -y                  # All platforms, auto-confirm
npx cli-ai-skills install skill-creator    # Specific skill

list / ls

List installed skills.

npx cli-ai-skills list
npx cli-ai-skills ls -q

update / up

Check and update skills.

npx cli-ai-skills update
npx cli-ai-skills up

doctor / doc

Diagnose installation issues.

npx cli-ai-skills doctor
npx cli-ai-skills doc

--bundle

Install curated skill collections.

npx cli-ai-skills --bundle essential
npx cli-ai-skills --bundle content -y
npx cli-ai-skills --bundle all

--search

Find skills by keyword.

npx cli-ai-skills --search "optimization"
npx cli-ai-skills --search "content"

--list-bundles

Show all available bundles.

npx cli-ai-skills --list-bundles

🆕 New in v1.5.0

• ✨ Command Shortcuts - i, ls, up, rm, doc
• 🚩 Short Flags - -a, -g, -l, -y, -q
• 📦 Bundle Support - --bundle <name>
• 🔍 Search Functionality - --search <keyword>
• 🎯 Zero-Config Install - Run with no args, auto-detects all platforms
• 📊 List Bundles - --list-bundles

⚙️ System Requirements

• Node.js 14.0.0 or higher
• npm or yarn
• One or more AI CLI tools installed:
  • GitHub Copilot CLI
  • Claude Code
  • OpenAI Codex

🆘 Troubleshooting

"Command not found"

# Ensure Node.js is installed
node --version

# Try with full npx path
npx cli-ai-skills

"No platforms detected"

Make sure at least one of these is installed:

• gh (GitHub CLI with Copilot)
• claude (Claude Code)
• codex (OpenAI Codex CLI)

"Permission denied"

# Check file permissions
chmod +x ~/.copilot/skills/*/

📦 What Gets Installed

The installer creates symlinks or copies skill files to:

~/.copilot/skills/              # GitHub Copilot
~/.claude/skills/               # Claude Code
~/.codex/skills/                # OpenAI Codex

Each skill includes:

• SKILL.md - Skill definition and documentation
• Support files and scripts
• Platform-specific configurations

🔗 Links

• Main Repository
• Skills Catalog
• Documentation
• Contributing

📄 License

MIT - Free to use, modify, and distribute.

Ready to get started? Run npx cli-ai-skills now! 🚀