Skip to content

README.md

Latest commit

 

History

History
86 lines (65 loc) · 3.19 KB

README.md

File metadata and controls

86 lines (65 loc) · 3.19 KB
Raw

skore-cli

PyPI Python versions Tests Coverage License

Command-line interface for skore.

skore-cli installs a single skore command with two areas:

  • skills — discover, install and manage Agent Skills from the probabl-ai/skills catalog
  • agent — connect a project to the Skore Hub agent, write harness config and launch a local coding agent

Installation

pip install skore-cli

The base install is batteries-included: it bundles the agent feature (so it pulls in skore). No extras are required.

Usage

Skills

Install skills into the current project by default. Pass --global/-g for a user-wide install and --agent/-a to target specific agents (agents, claude-code, cursor, codex, gemini).

skore skills list          # list installed skills
skore skills install       # install skills (interactive or by id)
skore skills update        # update installed skills
skore skills remove        # remove installed skills

Agent

On the first run, skore agent logs in when needed, lets you pick a workspace and harness, creates a workspace API key, writes the harness configuration and launches the agent. Supported harnesses: Claude, OpenCode and Pi (must be on PATH). Later runs reuse .skore in the project directory (gitignored). Use SKORE_HUB_URI (or --hub-url) to point at a non-default hub.

skore agent
skore agent --harness claude    # non-interactive harness choice
skore agent --workspace ./myapp # configure another project directory

Agent detection

When skore is run inside a coding agent, it detects the agent from environment variables and adapts its behavior:

  • skore (no args) shows an agent-specific quick-start with the detected agent's skill directory and harness
  • skore skills install (no args, non-interactive) prints the catalog and the detected agent's skill directory — no --agent flag needed
  • skore skills install all installs all skills into the detected agent's directory (also works with --all)
  • skore skills install <ids> installs specific skills into the detected agent's directory
  • skore agent (no --harness, non-interactive) auto-selects the detected agent's harness and skips the launch step (the agent is already running)
Agent Env Var
Claude Code CLAUDECODE
Cursor CURSOR_AGENT
Gemini CLI GEMINI_CLI
Codex CLI CODEX_SANDBOX
Pi PI_CODING_AGENT
OpenCode OPENCODE_CLIENT

Any non-empty value triggers detection.

License

MIT