basen-skll 0.1.0

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

skll — CLI

The premium CLI for installing curated skills into your AI coding agent.

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

Install from PyPI

pip install basen-skll
skll --help

Requires Python 3.10 or higher.

Install locally (development)

Requires Python 3.10+.

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:

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

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

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.