basen-skll 0.3.1

skll — Curated skills for AI coding agents, by BasenAI.

skll — CLI

The official CLI for installing curated AI agent skills from the SKLL marketplace.

████████████  ████    ████  ████          ████
████          ████    ████  ████          ████
████████████  █████████     ████          ████
        ████  █████████     ████          ████
        ████  ████    ████  ████          ████
████████████  ████    ████  ████████████  ████████████
        skll - by basenai

Quick Start

# Install
pip install basen-skll

# Sign in
skll login

# Browse available skills
skll search fastapi
skll search python
skll search authentication

# Install a skill
skll install @basen/skills/framer-motion --agent claude-code

# View installed skills
skll list

Requires Python 3.10 or higher.

What is skll?

skll connects your AI coding agents to a curated marketplace of production-ready skills, prompts, and workflows. Install expert-crafted skills directly into your agent's configuration with a single command.

Real skills. Real marketplace. Ready to use.

---

MCP Server

skll-mcp is a Model Context Protocol server that lets any MCP-capable coding agent search and install skills without leaving the chat. It runs over stdio — the standard MCP transport — so it works in every agent that supports MCP.

Install

The MCP server is an optional extra. Install it alongside the CLI:

pip install "basen-skll[mcp]"

Verify the binary is available:

skll-mcp --help   # should print FastMCP usage

Auto-setup (detects installed agents)

skll mcp setup

Scans for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, and Codex CLI. Writes the correct config for each one it finds and prompts before making changes.

skll mcp status   # show which agents are already configured

Manual setup (any MCP client)

Add the following to your MCP client's config. Every client that speaks the MCP stdio transport works — copy the snippet for your client:

Claude Code / Claude Desktop (~/.claude.json or claude_desktop_config.json):

{
  "mcpServers": {
    "skll": {
      "command": "skll-mcp",
      "args": []
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "skll": {
      "command": "skll-mcp",
      "args": []
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "skll": {
      "command": "skll-mcp",
      "args": []
    }
  }
}

VS Code / GitHub Copilot (user settings.json):

{
  "mcp.servers": {
    "skll": {
      "command": "skll-mcp",
      "args": []
    }
  }
}

Codex CLI (official CLI registration):

codex mcp add skll -- skll-mcp

Any other MCP client — use the universal stdio recipe:

command : skll-mcp
args    : []
transport: stdio

After adding the config, restart your agent for the tools to appear.

Available tools

Once connected, your agent has five tools:

Tool	Description
skll_search	Search the marketplace by keyword
skll_install	Install a skill into the correct agent directory
skll_list	List installed skills for the connected agent
skll_remove	Uninstall a skill
skll_auth	Check authentication status or sign out

The server auto-detects which agent is connected from the MCP initialize handshake, so skills are installed to the right place automatically.

Supported agent detection

The following agents are auto-detected when connected via MCP:

claude-code · cursor · windsurf · github-copilot · continue · zed · gemini-cli · codex · roo · kilo · cline · goose · warp

Any other MCP client falls back to claude-code paths. You can still install skills manually to the correct directory via the CLI (skll install) after connecting.

---

Authentication

Sign in with your skll account to access the full marketplace:

skll login      # Opens browser for secure authentication
skll whoami     # Verify your session
skll logout     # Sign out

Finding Skills

Search the marketplace by keyword, technology, or use case:

skll search fastapi           # Find FastAPI-related skills
skll search "api design"      # Search by phrase
skll search authentication    # Security & auth skills

View detailed information about any skill:

skll info @basen/skills/framer-motion

Installing Skills

Install skills directly into your agent's configuration directory:

# Install for a specific agent (project scope)
skll install @basen/skills/framer-motion --agent claude-code

# Install globally (user scope)
skll install @basen/skills/python-testing --agent cursor --global

Skills are automatically placed in the correct directory structure for your agent:

• Claude Code: ~/.claude/skills/ or ./.claude/skills/
• Cursor: ~/.cursor/skills/ or ./.cursor/skills/
• Other agents: See supported agents below

Managing Installed Skills

# List all installed skills
skll list

# List skills for a specific agent
skll list --agent claude-code

# Remove a skill
skll remove @basen/skills/framer-motion --agent claude-code

Supported Agents

• claude-code - Claude Code CLI
• cursor - Cursor IDE
• windsurf - Windsurf IDE
• github-copilot - GitHub Copilot / VS Code
• gemini-cli - Google Gemini CLI
• codex - OpenAI Codex CLI
• continue - Continue
• zed - Zed editor
• cline - Cline
• roo - Roo Code
• kilo - Kilo Code
• goose - Goose
• warp - Warp
• opencode - OpenCode
• replit - Replit
• ...and 70+ more agents

Commands Reference

Command	Description
skll login	Sign in to your skll account
skll logout	Sign out and clear local session
skll whoami	Display current user information
skll search <query>	Search the skill marketplace
skll info <skill>	View detailed skill information
skll install <skill> --agent <name>	Install a skill for an agent
skll list	List all installed skills
skll remove <skill> --agent <name>	Uninstall a skill
skll mcp setup	Register skll-mcp with agents
skll mcp status	Show current MCP registrations

Local Configuration

skll stores configuration in ~/.skll/:

• config.json - Authentication session
• installed.json - Locally installed skills registry

Links

• Website: https://basen-skll.vercel.app
• Documentation: https://basen-skll.vercel.app/cli
• Marketplace: https://basen-skll.vercel.app
• Support: [e-mail]

License

Proprietary software. Copyright © 2026 BasenAI. All rights reserved.

This software is distributed under a proprietary license. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited.