Agent skill

Using Xskill

by SkillNerds in SkillNerds/xskill

A skill your agent uses when installing, configuring, or operating xskill (the xskill CLI / pip install xskill) — starting the daemon, registering trajectory dirs, joining a team server…

MITAuto-check passed

Install Using Xskill

skills CLI
$ npx skills add SkillNerds/xskill --skill using-xskill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install SkillNerds/xskill using-xskill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/using-xskill .claude/skills/using-xskill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
using-xskill
GitHub stars
128
Token cost
~868 tokens
SKILL.md length
403 words
Files
4 (incl. references)
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when installing, configuring, or operating xskill (the xskill CLI / pip install xskill) — starting the daemon, registering trajectory dirs, joining a team server…

  • Operating xskill (the xskill CLI / pip install xskill) — starting the daemon
  • SKILL.md covers Overview, When to Use, Quick Reference and Progressive Disclosure — read…, plus 1 more section
  • Calls pip
  • Registering trajectory dirs

What it does

Using Xskill is an agent skill from SkillNerds/xskill. Use when installing, configuring, or operating xskill (the xskill CLI / pip install xskill) — starting the daemon, registering trajectory dirs, joining a team server, understanding how trajectories become Skills, or rebuilding/re-distilling the skill library after a model change.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/installation.md`, `references/mechanisms.md` and `references/rebuilding-skill-library.md`).

The repository describes itself as: Self-evolving skills lib for coding agents. The licence is MIT.

When your agent uses it

  • Operating xskill (the xskill CLI / pip install xskill) — starting the daemon
  • Registering trajectory dirs
  • Joining a team server
  • Understanding how trajectories become Skills

Example prompts

  • “/using-xskill”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit aeee7c1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Using Xskill loads about 868 tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 403 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~868
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from SkillNerds/xskill at commit aeee7c1, republished under its MIT licence (© SkillNerds). 403 words, ~868 tokens.

Download SKILL.mdSave it as .claude/skills/using-xskill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
using-xskill
description
Use when installing, configuring, or operating xskill (the `xskill` CLI / `pip install xskill`) — starting the daemon, registering trajectory dirs, joining a team server, understanding how trajectories become Skills, or rebuilding/re-distilling the skill library after a model change.

Using xskill

Overview

xskill distills reusable Skills (SKILL.md folders) out of the real execution trajectories of coding agents (Claude Code, Codex, OpenCode, Cursor, …). A background daemon watches each agent's session logs, slices them into single-intent atoms, clusters atoms into skills, and writes/versions each skill in its own git folder. New skill versions only replace old ones when real traffic shows they serve users better (canary A/B by UX score) — not by an LLM grading itself.

Core mental model: raw trajectory → atoms → candidate routing → SKILL.md → canary A/B → installed into every agent's skill dir. You operate the daemon; the daemon does the distilling.

When to Use

  • Installing xskill or filling in ~/.xskill/config.yaml (LLM + embedding endpoints)
  • Starting/keeping the daemon running (xskill serve), or backfilling old trajectories
  • Joining or hosting a team server (xskill serve --server / xskill connect)
  • Understanding the agent pipeline, atoms, canary/UX scoring, or deployment modes
  • Re-distilling the whole skill library (e.g. after switching to a stronger model)

Quick Reference

CommandWhat it does
pip install xskillInstall (Python 3.9+)
xskill serveStandalone daemon: FastAPI + watcher; first run writes ~/.xskill/config.yaml then exits
xskill serve --serverTeam server: owns all LLM calls + git; prints a join token
xskill connect <host:port> --token <t>Join a team server as a thin client
xskill registry add <path>Backfill / watch an extra trajectory directory
xskill traj search <query> / xskill search <query>Search trajectories or skills
xskill read <path> --eco <eco>Batch-ingest db trajectories (ngagent/opencode)
xskill rebuild [--force]Re-distill from existing raw trajectories (see reference)
xskill statsToken usage & estimated cost

The daemon is the engine: most commands only change state in the DB; nothing is distilled unless xskill serve (or the team server) is running.

Show full SKILL.md (125 more words)Show less

Progressive Disclosure — read on demand

  • Install & configure (config.yaml fields, per-agent collect/install paths, team client setup): references/installation.md
  • How it works (TaskAgent → TaskClusterAgent → SkillEditAgent, atoms, canary/UX scoring, standalone vs team mode): references/mechanisms.md
  • Rebuild the skill library (a ready-to-run prompt that walks a model through re-distilling correctly): references/rebuilding-skill-library.md

Common Mistakes

  • Running rebuild with no daemon up. rebuild only resets DB state; the watcher in serve does the actual re-split/re-cluster every 30s. No daemon = nothing happens.
  • Deleting raw ~/.xskill/*_sessions/*.md. Those are the input to distillation — delete them and you can no longer rebuild.
  • Expecting DeepSeek to do embeddings. DeepSeek has no embedding endpoint; point the embedding: block at DashScope / OpenAI / Ollama.
  • Putting tokens in public places. Team join tokens must never land in a public repo or chat log.

© SkillNerds, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/using-xskill of SkillNerds/xskill.

  • SKILL.md
  • references/installation.md
  • references/mechanisms.md
  • references/rebuilding-skill-library.md

Open the folder on GitHubat commit aeee7c1

Compare with similar skills

Using Xskill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Using Xskill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Xskill this skillSkillNerds/xskill128—~868Automated safety check: PassMIT
Configure Channelopenclaw/openclaw392k—~946Automated safety check: PassMIT
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
Generating Python Installeraffaan-m/ECC275k1 repos~6.1kAutomated safety check: PassMIT
Markstream Installsickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassMIT
Markstream Installgithub/awesome-copilot40k—~1.5kAutomated safety check: PassMIT

Similar skills

  • Configure Channel

    openclaw/openclaw

    Configure and prove a chat channel with non-interactive one-liners; secrets only as SecretRefs.

    392k GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Commercial-grade Python installer expert for Windows: Nuitka extreme compilation, dist slimming, DLL footprint analysis, and Inno Setup packaging to ship the smallest, fastest installers.

    275k GitHub starsUsed in 1 repo~6.1k tokens
    Testing & QAAuto-check passed
  • Markstream Install

    sickn33/agentic-awesome-skills

    Install and configure Markstream streaming Markdown renderers for Vue, React, Svelte, Angular, Nuxt, Next.js, and Vue 2 applications.

    47k GitHub starsUsed in 1 repo~2k tokens
    Frontend & DesignAuto-check passed
  • Markstream Install

    github/awesome-copilot

    Official

    Install and configure Markstream streaming Markdown renderers for Vue, React, Svelte, Angular, Nuxt, and Vue 2 applications.

    40k GitHub stars~1.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Configuring Snort Ids For Intrusion Detection

    mukul975/Anthropic-Cybersecurity-Skills

    Installs, configures, and tunes Snort 3 to monitor network traffic for malicious activity using custom and community rulesets, preprocessors, and alert output plugins.

    34k GitHub stars~3.5k tokensUpdated 1 mo ago
    SecurityAuto-check: notes

More from SkillNerds/xskill

  • Xskill Helper

    SkillNerds/xskill

    A skill your agent uses for xskill. An agent skill from SkillNerds/xskill.

    128 GitHub stars~3.4k tokensUpdated 21 days ago
    Auto-check: warnings
  • Xskill Dev

    SkillNerds/xskill

    A skill your agent uses when developing xskill itself — editing agent tool docstrings, changing the generate agent tool surface, or verifying what schema the Agno framework actually sends to the…

    128 GitHub stars~422 tokensUpdated 21 days ago
    Auto-check passed
  • Xskill Registry DB First

    SkillNerds/xskill

    XSkill 数据访问原则:文件系统是内容真相,由 worker 同步进库;面板与业务读 请求只走数据库;内核 agent loop 可直接写盘。适用于改 dashboard、recommend、 team、pipeline、ecosystems 等读路径,以及审查是否又引入业务侧扫盘。

    128 GitHub stars~253 tokensUpdated 21 days ago
    Auto-check passed

Questions about Using Xskill

What does Using Xskill do?

A skill your agent uses when installing, configuring, or operating xskill (the xskill CLI / pip install xskill) — starting the daemon, registering trajectory dirs, joining a team server…. Using Xskill is an agent skill from SkillNerds/xskill. Use when installing, configuring, or operating xskill (the xskill CLI / pip install xskill) — starting the daemon, registering trajectory dirs, joining a team server, understanding how trajectories become Skills, or rebuilding/re-distilling the skill library after a model change.

When should I use Using Xskill?

Using Xskill fits situations like: operating xskill (the xskill CLI / pip install xskill) — starting the daemon; registering trajectory dirs; joining a team server; understanding how trajectories become Skills.

How do I install Using Xskill in Claude Code?

Run `npx skills add SkillNerds/xskill --skill using-xskill -a claude-code`. Or copy the skill folder (skills/using-xskill in SkillNerds/xskill) into .claude/skills/using-xskill in your project. Claude Code loads it when a task matches its description.

How do I install Using Xskill in Codex?

Run `npx skills add SkillNerds/xskill --skill using-xskill -a codex`. Or copy the skill folder (skills/using-xskill in SkillNerds/xskill) into .agents/skills/using-xskill in your project. Codex loads it when a task matches its description.

Can I use Using Xskill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SkillNerds/xskill --skill using-xskill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-xskill, .gemini/skills/using-xskill, .github/skills/using-xskill and .opencode/skills/using-xskill in your project.

What does Using Xskill need to run?

Going by SKILL.md and its folder, Using Xskill needs the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does Using Xskill access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Using Xskill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Using Xskill use?

Using Xskill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Using Xskill use?

About 868 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.

What are the alternatives to Using Xskill?

Skills that share tags, products or a category with Using Xskill: Configure Channel (openclaw/openclaw, 392k stars), Kubeshark Installer (kubeshark/kubeshark, 12k stars), Generating Python Installer (affaan-m/ECC, 275k stars) and Markstream Install (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Xskill?

SkillNerds (a GitHub organization) maintains it in SkillNerds/xskill, which has 128 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 17, 2026.

Source: SkillNerds/xskill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.