Metadata-Version: 2.4
Name: basen-skll
Version: 0.1.5
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/get-started
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'
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/fastapi-best-practices --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.**

## 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/fastapi-best-practices
```

## Installing Skills

Install skills directly into your agent's configuration directory:

```bash
# Install for a specific agent (project scope)
skll install @basen/skills/fastapi-best-practices --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/prompts/` or `./.cursor/prompts/`
- **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/fastapi-best-practices --agent claude-code
```

## Supported Agents

- **claude-code** - Claude Code CLI
- **cursor** - Cursor IDE
- **codex** - OpenAI Codex
- **gemini** - Google Gemini
- **opencode** - OpenCode
- **antigravity** - Antigravity
- **copilot** - GitHub Copilot
- **kiro** - Kiro
- **agents** - Generic agent directory

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

## 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/get-started
- **Marketplace:** https://basen-skll.vercel.app
- **Support:** support@basen.ai

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