bskills

Unified skill management for AI code assistants — by A2AX

bskills is an interactive terminal tool for installing, managing, and syncing AI agent skills across multiple AI code assistants from a single interface.

Features

• Unified Skill Management - Install, update, and remove skills across 17 AI agents from one CLI
• Interactive Terminal UI - Beautiful React/Ink-powered interface with keyboard navigation
• Marketplace Integration - Discover and install skills from curated marketplaces
• Multiple Installation Modes - Choose between symlink (shared) or copy (isolated) installations
• Flexible Scopes - Install skills globally or per-project
• Git-Based Skills - Install skills directly from any Git repository

Supported AI Agents

bskills supports 17 AI code assistants:

| Agent | Description | |-------|-------------| | Claude Code | Anthropic Claude Code CLI | | Cursor | Cursor AI IDE | | Windsurf | Codeium Windsurf IDE | | GitHub Copilot | GitHub Copilot | | Roo Code | Roo Code AI assistant | | OpenCode | OpenCode AI coding assistant | | Cline | Cline VS Code extension | | Amp | Sourcegraph Amp | | Aider | Aider AI pair programming | | Codex | OpenAI Codex CLI | | Continue | Continue IDE extension | | Void | Void AI assistant | | PearAI | PearAI IDE | | Zed | Zed code editor | | Trae | Trae AI IDE | | Melty | Melty AI assistant | | Aide | Aide AI coding assistant |

Installation

npm install -g bskills

Or run without installing:

npx bskills

Prerequisites

• Node.js >= 18.0.0
• Git (for installing skills from repositories)

Quick Start

# Launch interactive mode (default)
bskills

# Add a marketplace
bskills marketplace add https://github.com/your-org/skill-marketplace

# Install a skill from marketplace
bskills install skill-name

# Install a skill from a Git URL
bskills install https://github.com/user/my-skill

# List installed skills
bskills list

Usage

Interactive Mode

Running bskills without arguments launches the interactive terminal UI where you can browse marketplaces, search skills, and manage installations with keyboard navigation.

bskills

CLI Commands

| Command | Aliases | Description | |---------|---------|-------------| | install <skill> | i, add | Install a skill to AI agents | | uninstall <skill> | remove, rm | Uninstall a skill from AI agents | | update <skill> | upgrade | Update a skill to the latest version | | disable <skill> | - | Disable a skill (preserves files) | | enable <skill> | - | Re-enable a disabled skill | | installed | list, ls | List all installed skills | | marketplace | mp | Manage skill marketplaces | | agents | - | List detected AI agents | | config | - | View or modify configuration | | help | ?, commands | Show available commands |

Common Options

-a, --agent <agent>       Target a specific agent (e.g., claude-code, cursor)
-s, --scope <scope>       Installation scope: global or project
-m, --mode <mode>         Installation mode: symlink or copy

Examples

# Install a skill globally for all agents
bskills install code-review --scope global

# Install a skill only for Claude Code
bskills install refactoring --agent claude-code

# Install with copy mode (isolated installation)
bskills install testing-utils --mode copy

# Update all skills for Cursor
bskills update --agent cursor

# List skills installed for a specific agent
bskills list --agent windsurf

Configuration

Configuration is stored at ~/.buyskills/config.json.

Options

| Option | Default | Description | |--------|---------|-------------| | defaultInstallMode | "symlink" | Default installation mode (symlink or copy) | | defaultScope | "global" | Default installation scope (global or project) |

Managing Configuration

# View all configuration
bskills config

# View a specific setting
bskills config defaultInstallMode

# Set a configuration value
bskills config defaultInstallMode copy
bskills config defaultScope project

Marketplace

Marketplaces are Git repositories containing curated collections of skills.

Managing Marketplaces

# Add a marketplace
bskills marketplace add https://github.com/org/marketplace-repo

# List configured marketplaces
bskills marketplace list

# Sync marketplace data (fetch latest skills)
bskills marketplace sync

# Remove a marketplace
bskills marketplace remove marketplace-id

Hosting Your Own Marketplace

Create a Git repository with a marketplace.json file:

{
  "name": "My Skill Marketplace",
  "description": "A collection of useful AI agent skills",
  "skills": [
    {
      "name": "code-review",
      "description": "Comprehensive code review skill",
      "repository": "https://github.com/user/code-review-skill",
      "tags": ["review", "quality"],
      "category": "development"
    }
  ]
}

Installation Modes & Scopes

Installation Modes

| Mode | Description | Use Case | |------|-------------|----------| | symlink | Creates symbolic links to the skill source | Shared skills, automatic updates when source changes | | copy | Copies skill files to the target location | Isolated installations, offline usage |

Installation Scopes

| Scope | Location | Description | |-------|----------|-------------| | global | ~/.{agent}/skills/ | Available in all projects | | project | ./{agent}/skills/ | Only available in current project |

Skill Format

Skills are defined using a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: A helpful skill that does something useful
version: 1.0.0
author: Your Name
tags:
  - productivity
  - automation
category: development
license: MIT
repository: https://github.com/user/my-skill
---

# My Skill

Instructions and guidance for the AI agent...

## When to Use

Use this skill when you need to...

## Examples

Here are some examples of how to use this skill...

Supported File Names

Skills are detected from files in this order of priority:

1. SKILL.md
2. skill.md
3. README.md
4. readme.md

Development

# Clone the repository
git clone https://github.com/A2AXdev/a2ax-cli.git
cd a2ax-cli

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode (watch)
npm run dev

# Run tests
npm test

# Lint and format
npm run lint
npm run format

# Type check
npm run typecheck

Tech Stack

• Runtime: Node.js 18+
• Language: TypeScript 5.3
• UI Framework: React + Ink (Terminal UI)
• Build Tool: tsup
• Testing: Vitest
• Linting: Biome
• Git Operations: simple-git
• Schema Validation: Zod

License

MIT