Skip to main content

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

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.

Metadata

Release files for basen-skll 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for basen-skll 0.3.2
File Size Uploaded
basen_skll-0.3.2.tar.gz 57.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for basen-skll 0.3.2
File Interpreter ABI Platform
basen_skll-0.3.2-py3-none-any.whl Python 3 none any Details

Total release size: 94.6 kB

Release files / basen_skll-0.3.2.tar.gz

Download URL basen_skll-0.3.2.tar.gz
Size 57.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e1bf24533fc9678b470afc5a0e5904c27787dbf892a3bcb5108a43083a0da9fa
BLAKE2b-256 checksum
How to use checksums
8e57d7d32236c14e329c02f7ae4106b7394213a1eec2ce082c685a520a622a71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 25, 2026.

Transparency log

Release files / basen_skll-0.3.2-py3-none-any.whl

Download URL basen_skll-0.3.2-py3-none-any.whl
Size 37.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce3ece9ad4b6f9fd185a07299259f47a8cec8712e25a9bcff615b3b7964c39c3
BLAKE2b-256 checksum
How to use checksums
2bae0a1b3b4d21f03c50cd59cb946129c556fd0db626e22d148557b2722be25a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 25, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page