πŸ“– the xskill wiki

xskill documentation

Written for people who just arrived. Commands stay in English; the rest is plain language.

Edit this wiki on GitHub β†’

Overview

Quickstart

$ pip install 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:
  # DeepSeek has no embedding model; use DashScope / OpenAI / Ollama.
  base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
  model:    text-embedding-v4
  api_key:  YOUR_KEY
  dim:      0

$ xskill registry add /path/to/trajectories

Common commands

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

xskill generate

When to use it

How

$ xskill generate "ζŠŠε€„η†ε‘η₯¨ζŠ₯ι”€ηš„ζ­₯ιͺ€ε†™ζˆζŠ€θƒ½"
$ xskill generate --name alice,bob "ζŠŠδ»–δ»¬ε€„η†ε‘εΈƒε€±θ΄₯ηš„εŠžζ³•ε†™ζˆζŠ€θƒ½"

Notes

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

Add a docs page

Concepts

Five terms cover the whole system:

TermMeaning
Trajectory
Atom
Skill
Canary
UX score

How it works

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 <token> --name <user-id>
  • β€”
  • β€”
  • β€”
  • β€”
  • β€”

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

MIT Β© 370025263. See the LICENSE file in the repository.