Efx-ai-skills

A beautiful TUI (Terminal User Interface) for discovering, previewing, and managing AI agent skills across multiple providers.

✨ Features

• 🔍 Unified Search - Search skills from skills.sh and playbooks.com registries
• 👀 Beautiful Preview - View skill documentation with rendered Markdown
• 📦 Centralized Storage - One skill library (~/.agents/skills/) shared across all providers
• 🔗 Smart Linking - Symlink skills to multiple providers (Claude, Cursor, Qoder, Windsurf, Copilot, Codex)
• 🎨 Intuitive TUI - Built with Charm's Bubble Tea
• ⚡ Fast & Lightweight - Single Go binary, no dependencies
• 🔄 Sync Management - Keep skills in sync across all providers
• ⌨️ Keyboard-First - Navigate everything with vim-style keybindings

🎯 Concept

efx-ai-skills solves the problem of managing AI agent skills across different providers. Instead of downloading the same skill multiple times or manually copying files, it provides:

1. Central Storage - All skills stored once in ~/.agents/skills/
2. Provider Linking - Symlinks to provider directories (~/.claude/skills/, ~/.cursor/skills/, etc.)
3. Easy Discovery - Search 100+ skills from multiple registries
4. Visual Management - See which providers have which skills at a glance

📥 Installation

From Source

# Clone the repository
git clone https://github.com/electroheadfx/efx-ai-skills.git
cd efx-ai-skills

# Build the binary
make build

# Install to your PATH
sudo mv bin/efx-skills /usr/local/bin/

Using Go Install

go install github.com/electroheadfx/efx-ai-skills@latest

Prerequisites

• Go 1.22 or later (for building from source)
• Terminal with Unicode support
• Supported OS: macOS, Linux

🚀 Quick Start

Launch the TUI

# Start the main interface (status view)
efx-skills

Search for Skills

# Search from the TUI
efx-skills search

# Or search with a query
efx-skills search "react"

Preview a Skill

# Preview skill documentation
efx-skills preview vercel-labs/agent-skills/react-best-practices

View Status

# Show provider status
efx-skills status

🎮 Usage

Navigation

Status View (default)

• s - Open search
• ↑/↓ - Navigate providers
• Enter / m - Manage provider skills
• c - Open configuration
• r - Refresh status
• q - Quit

Search View

• Type to search across registries
• ↵ - Execute search (when focused on input)
• Tab - Toggle focus between input and results
• ↑/↓ or j/k - Navigate results
• p or Enter - Preview selected skill
• i - Install skill
• ←/→ - Page navigation
• Esc - Back to status

Preview View

• j/k or ↑/↓ - Scroll line by line
• Space/b - Page down/up
• g/G - Jump to top/bottom
• Esc - Back to search

CLI Commands

# Search skills
efx-skills search "authentication"

# Preview a skill
efx-skills preview yoanbernabeu/grepai-skills/find-skills

# Install a skill
efx-skills install <skill-name> -p claude -p cursor

# List installed skills
efx-skills list

# Show provider status
efx-skills status

# Sync all providers
efx-skills sync

# Manage configuration
efx-skills config

# Show version
efx-skills --version

📁 Directory Structure

~/.agents/
├── skills/                    # Central skill storage
│   ├── find-skills/
│   │   └── SKILL.md
│   ├── grepai-installation/
│   │   └── SKILL.md
│   └── ...
└── .skill-lock.json          # Lock file

~/.claude/skills/             # Symlinks to central storage
~/.cursor/skills/             # Symlinks to central storage
~/.qoder/skills/              # Symlinks to central storage
~/.windsurf/skills/           # Symlinks to central storage
~/.codex/skills/              # Symlinks to central storage

🎨 Supported Providers

efx-ai-skills can manage skills for the following AI coding assistants:

• Claude (~/.claude/skills/) - Anthropic's Claude Desktop
• Cursor (~/.cursor/skills/) - Cursor AI Editor
• Qoder (~/.qoder/skills/) - Qoder AI Assistant
• Windsurf (~/.windsurf/skills/) - Windsurf Editor
• GitHub Copilot (~/.copilot/skills/) - GitHub Copilot
• Cline (~/.cline/skills/) - Cline VSCode Extension
• Roo Code (~/.roo-code/skills/) - Roo Code Extension
• OpenCode (~/.config/opencode/skills/) - OpenCode Assistant
• Codex (~/.codex/skills/) - OpenAI Codex CLI
• Continue (~/.continue/skills/) - Continue.dev Extension

Each provider can be individually enabled/disabled in the configuration.

🎨 Screenshots

Main Menu (Home)

The default view shows the status of all configured AI providers, displaying which providers have skills installed and their sync status.

Search Skills

Search for skills across multiple registries (skills.sh and playbooks.com) with an intuitive interface. Navigate results and preview skills directly.

Preview Skills

View beautifully rendered markdown documentation for any skill before installing. Supports scrolling through long documentation with vim-style keybindings.

Manage Provider Skills

Select which skills to enable or disable for specific providers. Toggle individual skills with checkboxes.

Configuration

Manage custom sources, registries, and provider settings through the configuration interface.

🔧 Configuration

Configuration is stored in ~/.config/efx-skills/config.json:

{
  "registries": [
    {
      "name": "skills.sh",
      "url": "https://skills.sh/api/search",
      "enabled": true
    },
    {
      "name": "playbooks.com",
      "url": "https://playbooks.com/api/skills",
      "enabled": true
    }
  ],
  "repos": [
    "yoanbernabeu/grepai-skills"
  ],
  "enabled_providers": [
    "claude",
    "cursor",
    "qoder",
    "codex"
  ]
}

🏗️ Architecture

efx-ai-skills uses a centralized storage model with provider linking:

1. Skills are downloaded once to ~/.agents/skills/
2. Providers reference via symlinks to their respective directories
3. TUI manages the relationships between skills and providers
4. Lock file tracks state for consistency

Built with:

• Bubble Tea - TUI framework
• Bubbles - TUI components
• Glamour - Markdown rendering
• Lipgloss - Styling
• Cobra - CLI framework

📋 Changelog

v0.2.1

• Added OpenAI Codex provider support at ~/.codex/skills/
• Centralized provider definitions so future provider additions happen in one place

v0.1.4

• Fixed skill removal from providers not working for non-symlinked directories
• Fixed manage view not showing provider-only skills (not in central storage)
• Fixed config not loading saved state (repos and provider toggles lost on reopen)
• Fixed provider toggle not reflected in main menu status view
• Updated screenshots

v0.1.3

• Fixed slow markdown preview rendering by replacing glamour.WithAutoStyle() with glamour.WithStandardStyle("dracula")

v0.1.2

• Cleaned old folder/files
• Grouped cmux skill to cmux folder
• Modified theme for folder skills
• Added collapsed skills folder
• Changed provider shortcut, added skill preview, changed theme

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see LICENSE file for details

👤 Author

Laurent Marques (efx)

© 2026 efx - Laurent Marques

🙏 Acknowledgments

• Charmbracelet for the amazing TUI libraries
• skills.sh and playbooks.com for skill registries
• All skill authors contributing to the AI agent ecosystem

Efx-ai-skills - Making AI agent skill management simple and beautiful ✨