Metadata-Version: 2.4
Name: basen-skll
Version: 0.3.2
Summary: skll — Curated skills for AI coding agents, by BasenAI.
Project-URL: Homepage, https://basen-skll.vercel.app
Project-URL: Documentation, https://basen-skll.vercel.app/cli
Project-URL: Repository, https://github.com/basenai/skll
Project-URL: Issues, https://github.com/basenai/skll/issues
Project-URL: Changelog, https://github.com/basenai/skll/blob/main/cli/CHANGELOG.md
Author-email: BasenAI <team@basen.ai>
Maintainer-email: BasenAI <team@basen.ai>
License: Proprietary
License-File: LICENSE
Keywords: agents,ai,claude,cli,coding-agents,cursor,prompt-engineering,skills
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: platformdirs>=4.2.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: questionary>=2.0.1
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.3
Provides-Extra: dev
Requires-Dist: mypy>=1.9.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Provides-Extra: mcp
Requires-Dist: mcp[cli]>=1.9.0; extra == 'mcp'
Description-Content-Type: text/markdown

# skll — CLI

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

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

## Quick Start

```bash
# 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:

```bash
pip install "basen-skll[mcp]"
```

Verify the binary is available:

```bash
skll-mcp --help   # should print FastMCP usage
```

### Auto-setup (detects installed agents)

```bash
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.

```bash
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`):

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

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

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

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

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

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

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

**Codex CLI** (official CLI registration):

```bash
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:

```bash
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:

```bash
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:

```bash
skll info @basen/skills/framer-motion
```

## Installing Skills

Install skills directly into your agent's configuration directory:

```bash
# 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

```bash
# 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](https://basen-skll.vercel.app)

## 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:** danialhashmi418@gmail.com

## 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.
