Metadata-Version: 2.4
Name: basen-skll
Version: 0.1.0
Summary: skll — Curated skills for AI coding agents, by BasenAI.
Project-URL: Homepage, https://skll.basen.ai
Project-URL: Documentation, https://skll.basen.ai/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: MIT
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: License :: OSI Approved :: MIT License
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 premium CLI for installing curated skills into your AI coding agent.

```
   ▄▄▄▄▄ ▄  ▄ ▄    ▄
  █     █  █ █     █
  ▀▄▄▄  ▀▄▄▄ █▄▄▄  █▄▄▄
        skll · by basenai
```

## Install from PyPI

```bash
pip install basen-skll
skll --help
```

Requires Python 3.10 or higher.

## Install locally (development)

Requires Python 3.10+.

```bash
cd cli
uv venv
source .venv/bin/activate          # macOS / Linux
# .venv\Scripts\activate           # Windows PowerShell
uv pip install -e .
skll --help
```

Or with plain pip:

```bash
cd cli
python -m venv .venv && source .venv/bin/activate
pip install -e .
skll --help
```

## Try it end-to-end (Phase 1 — mock data)

```bash
skll login                                                 # mock browser flow
skll whoami
skll search fastapi
skll info @basen/skills/fastapi
skll install @basen/skills/fastapi --agent claude-code --global
skll list
skll remove @basen/skills/fastapi --agent claude-code
skll logout
```

Real files are written to disk at the correct agent path (e.g.
`~/.claude/skills/fastapi/`). Local state lives in `~/.skll/`:

- `config.json` — session token
- `installed.json` — locally tracked installs
- `events.jsonl` — append-only download events

## Commands

| Command                                                  | Purpose                                   |
|----------------------------------------------------------|-------------------------------------------|
| `skll login`                                             | Sign in via browser (mock OAuth)          |
| `skll logout`                                            | Clear local token                         |
| `skll whoami`                                            | Show current session                      |
| `skll search <q>`                                        | Search the catalog                        |
| `skll info @basen/skills/<name>`                         | Inspect a skill                           |
| `skll install @basen/skills/<name> --agent <a> [--global]` | Install into agent folder structure     |
| `skll list [--agent <a>]`                                | List locally installed skills             |
| `skll remove @basen/skills/<name> --agent <a>`           | Uninstall a skill                         |

## Supported agents

`claude-code`, `codex`, `gemini`, `opencode`, `antigravity`, `copilot`,
`cursor`, `kiro`, `agents`.

## Architecture (Phase 1)

The CLI ships with a bundled mock catalog and mock skill source folders
under `skll/mock_skills/`. The `skll.api` module is the only swap-point
needed to wire the real backend in Phase 2.
