πŸ“– the xskill wiki

xskill documentation

Docs repo β†’

Overview

Quickstart

$ pip install -U xskill
$ xskill connect https://hub.xskill.wiki --token dd7f641c16ced6d1db43e754055fd2c8 --name YOUR_NAME

$ pip install -U xskill       # Python 3.9+
$ xskill serve                # writes ~/.xskill/config.yaml, then exits

skill_dir: ~/.xskill/skill

llm:
  base_url: https://api.deepseek.com
  model:    deepseek-v4-flash
  api_key:  YOUR_KEY

embedding:
  # LLM and embedding can share one DeepSeek endpoint; swap as needed.
  base_url: https://api.deepseek.com
  model:    deepseek-embedding
  api_key:  YOUR_KEY
  dim:      0

$ xskill serve                # start daemon & watcher
# optional: add an older trajectory archive
$ xskill registry add /path/to/trajectories

$ xskill serve --server                        # on server: prints join token
$ xskill connect <host:port> --token <token> --name <user-id>

Common commands

You want to…Use
xskill generate
xskill upload
xskill import
xskill search
Hand edits

xskill generate

When to use it

How

$ xskill generate ""
$ xskill generate --name alice,bob ""

xskill upload

When to use it

How

$ xskill upload ./my-skill
# teammates can then:
$ xskill search ζŠ€θƒ½ε
$ xskill download <skill-id>

Notes

xskill import

When to use it

How

$ xskill import ./my-skill
$ xskill import ./skills-folder

Notes

Hand-edit, then it uploads

When to use it

How

$ xskill status
# then edit ~/.xskill/skill/<name>/SKILL.md and save

Notes

Concepts

Five terms cover the whole system:

TermMeaning
Trajectory
Atom
Skill
Canary
UX score

How it works

  • β€”
  • β€”
  • β€”
  • β€”

Skill lifecycle

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6

  • β€”
  • β€”
  • β€”

Architecture

xskill architecture: agent ecosystems β†’ trajectory watcher β†’ atom splitter β†’ skill router β†’ skill edit agent β†’ canary A/B β†’ skill repository, with team mode

Supported agents

Trajectory ingest and Skill install are implemented per ecosystem:

AgentStatusTrajectory ingestSkill install
Claude Codeverified~/.claude/projects/~/.claude/skills/<name>/
Codex CLIverified~/.codex/sessions/~/.agents/skills/<name>/
OpenCodeverified~/.local/share/opencode/opencode.db~/.agents/skills/<name>/
OpenClawimplemented~/.openclaw/agents/~/.agents/skills/<name>/
Cursorimplemented~/.cursor/projects/*/agent-transcripts/~/.cursor/skills/<name>/
TraeimplementedIDE state.vscdb / CLI trajectory_*.json~/.trae-cn/skills/, ~/.trae/skills/
Any other agentmanualxskill.adapters.submit_trajectorycopy / symlink SKILL.md

Team mode

$ xskill serve --server                        # prints a join token
$ xskill connect <host:port> --token *** --name <user-id>
  • β€”
  • β€”
  • β€”
  • β€”
  • β€”

  • β€”
  • β€”
  • β€”
  • β€” 

$ xskill search docker compose        # compact metadata + skill ID
$ xskill search docker --download    # installs into the 10-slot LRU
$ xskill download <skill-id> --agent claude-code --agent codex -y
$ xskill upload ./my-skill           # whole team can search it right away

Persistent client

$ xskill status
$ xskill stop
$ xskill start

CLI reference

xskill serve [--host 0.0.0.0] [--port 8000] [--server]

xskill registry <add|remove|list> [path] [--label LABEL]

xskill connect [host:port] [--token TOKEN] [--name NAME] [--label LABEL] [--use-proxy] [--foreground]

xskill generate [--name NAME] PROMPT

xskill upload [--json] path

xskill import [--json] path

xskill search QUERY [--download] [--team | --local]

xskill download [--agent AGENT] [-y] skill_id

xskill status

xskill stop

xskill start

Configuration

llm:
  base_url: https://api.deepseek.com
  model:    deepseek-v4-flash
  api_key:  YOUR_KEY
  rate_limit:
    rpm: 60          # match your provider plan
    tpm: 100000      # optional
    burst: 10        # optional; default = ceil(rate/6)

Roadmap

News

License

Add a docs page