MCPcopy Index your code
hub / github.com/SkillNerds/xskill

github.com/SkillNerds/xskill @v0.6.1a9

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.6.1a9 ↗ · + Follow
2,837 symbols 11,803 edges 225 files 1,141 documented · 40%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

xskill — One solves it. Everyone gets it.

PyPI Python License GitHub

English · 简体中文


一个 coding agent 列出 xskill 从过往会话里蒸馏出的 Skill

动态

  • 2026-05-23 — 正式开源,发布 v0.5.0:团队模式(client-server)、隐私脱敏、Python 3.9 支持、无需 git依赖。详见 Release notes
  • 2026-05-20 — MIT 开源,PyPI 上架:pip install xskill
  • 2026-05-12 — Claude Code、Codex、OpenCode 支持;OpenClaw、Cursor对接。
  • 2026-05-29 — Trae IDE / Trae Agent 适配:读取 workspaceStorage 会话、Skill 安装至 ~/.trae-cn/skills / ~/.trae/skills

解决什么问题

agent 每次撞上同一个问题,都会把同一套解法重推一遍。你要么再讲一遍,要么自己维护一份 prompt 库——而这份库没人看的时候就慢慢腐烂。

xskill 跑起来之后,这件事不用你管了:

  • 跑通过的解题套路自动沉淀成 Skill 文件,agent 自己加载。
  • 你照常用 agent 干活,Skill 库自己长出来——没有审核队列,没人需要去"挑选最佳实践"。
  • 你手改某个 Skill,xskill 会立即借鉴重点学习。
  • 新版本只有真的把用户服务得更好,才会顶掉老版本(用户体验驱动进行进化,而非简单 LLM 开环评价)。

上手

pip install xskill          # 需要 Python 3.9+
xskill serve                # 生成 ~/.xskill/config.yaml 模板后退出

打开 ~/.xskill/config.yaml,填好两个模型 endpoint:

skill_dir: ~/.xskill/skill

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

embedding:
  base_url: https://api.deepseek.com
  model:    deepseek-embedding
  api_key:  YOUR_KEY
  dim:      0

再跑一次 xskill serve,它会自动扫机器上装好的所有 agent(Claude Code、Codex、OpenCode、OpenClaw、Cursor、Trae)开始监听。如果还有一份历史轨迹归档想一起吃进来:

xskill registry add /path/to/trajectories

团队模式:真正的杀手场景

xskill 真正想在组织里铺开的形态是团队模式:一台机器当 server,其他人作为瘦客户端接入,共用 server 上长出来的同一份 Skill 库。

xskill serve --server                        # 启动后打印 join token
xskill connect <host:port> --token <token>
  • 无感蒸馏大佬员工 一个人在自己工作里跑通的解法,自动可以让全团队复用,不需要任何人做任何事。(能力民主化)
  • 兼容各种 coding 方式 用 codex、clade 还是 cursor IDE? 都能加入,多端同步。
  • 轨迹隐私 轨迹上传前先脱敏,agent 隐私功能。
  • 灰度测试驱动的进化 一个 Skill 的改动会先在每个人身上分别衡量,赢了再扩散,人越多进化越准越快。
  • 专家指导的手动进化 专家本地直接修改 skill,会被学习进服务器远程 user-staging/<client_id> 分支,作为下一步进化参考。

架构图

xskill 架构:agent 生态 → 轨迹监听 → Atom 切分 → Skill 路由 → Skill 编辑 Agent → Canary A/B → Skill 仓库 ↔ 团队模式

工作原理

几个职责单一的 LLM agent 各管一摊:一个把轨迹切成单一意图的 Atom;一个把每个 Atom 路由到对应 Skill;一个等某个 Skill 攒够素材了就重写它的 SKILL.md;一个在真实流量上 A/B 测试新版本,留下赢家。每个 Skill 本身就是一个独立 git 仓库,改了什么、谁改的、能不能回退都有据可查。细节见 docs/agent.md

支持哪些 agent

Agent 状态 轨迹采集 Skill 安装
Claude Code ✅ 已验证 ~/.claude/projects/ symlink → ~/.claude/skills/<name>/
Codex CLI ✅ 已验证 ~/.codex/sessions/ symlink → ~/.agents/skills/<name>/
OpenCode ✅ 已验证 读 SQLite ~/.local/share/opencode/opencode.db symlink → ~/.agents/skills/<name>/
OpenClaw 🟡 已对接,not well tested ~/.openclaw/agents/ 拷贝 → ~/.agents/skills/<name>/
Cursor 🟡 已对接,not well tested ~/.cursor/projects/*/agent-transcripts/ symlink → ~/.cursor/skills/<name>/
Trae 🟡 已对接,not well tested IDE:读 %APPDATA%/Trae*/User/workspaceStorage/*/state.vscdb;CLI:扫 ~/trajectories/trajectory_*.json symlink → ~/.trae-cn/skills/ 与/或 ~/.trae/skills/
其他 agent 手动 SDK:xskill.adapters.submit_trajectory 自己拷贝 / symlink SKILL.md 目录

几个名词

术语 含义
Trajectory(轨迹) 一次 agent 执行——一段 session 的完整记录,存成 traj_*.md
Atom 轨迹里单一意图的最小片段。路由判断发生在这一级。
Skill 一个 SKILL.md 加可选脚本,住在自己的 git 仓库里,带版本。
Canary(灰度) 现有 Skill 与候选版本在真实流量上做 A/B。
UX score 某个 Skill 在某个 Atom 上服务用户的好坏,从交互本身打 1–10 分。灰度按这个分数选赢家。

Roadmap

  • 更多 agent adapter:Goose、OpenHands、Aider
  • 更为成熟的用户画像和推荐算法
  • 原生 MCP server 接口(把 Skill 暴露成 tool)
  • Web UI:浏览 Skill 库、看灰度数据
  • Skill marketplace:导入 / 导出可移植 bundle
  • 多租户 Skill 库(每个团队独立 skill_dir

License

MIT © 370025263,详见 LICENSE

Core symbols most depended-on inside this repo

get
called by 769
src/xskill/skill/repo.py
append
called by 477
src/xskill/canary.py
run_git
called by 138
src/xskill/skill/git.py
exists
called by 117
src/xskill/pipeline/cold_start.py
resolve
called by 107
src/xskill/usage.py
register_dir
called by 72
src/xskill/pipeline/registry.py
get_connection
called by 67
src/xskill/pipeline/registry.py
add_assistant
called by 50
scripts/bench/synthetic/gen_cases_v2.py

Shape

Function 1,464
Method 979
Class 324
Route 70

Languages

Python99%
TypeScript1%

Modules by API surface

src/xskill/api/app.py82 symbols
tests/test_task_agent.py75 symbols
tests/test_skill_edit_agent.py63 symbols
src/xskill/skill/git.py56 symbols
tests/test_openclaw_adapter.py50 symbols
src/xskill/agents/agent_tools.py49 symbols
src/xskill/pipeline/registry.py48 symbols
src/xskill/dashboard/router.py48 symbols
tests/test_watcher_atom.py46 symbols
src/xskill/pipeline/runner.py45 symbols
tests/test_skill_tools_atom.py44 symbols
tests/test_registry.py40 symbols

For agents

$ claude mcp add xskill \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page