Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
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…
Install Xskill Dev
$ npx skills add SkillNerds/xskill --skill xskill-dev -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install SkillNerds/xskill xskill-dev --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xskill-dev .claude/skills/xskill-dev && rm -rf skills-srcUse ~/.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/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .claude/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/SkillNerds/xskill/tree/main/skills/xskill-devType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add SkillNerds/xskill --skill xskill-dev -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install SkillNerds/xskill xskill-dev --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/xskill-dev .agents/skills/xskill-dev && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .agents/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SkillNerds/xskill --skill xskill-dev -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install SkillNerds/xskill xskill-dev --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/xskill-dev .cursor/skills/xskill-dev && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .cursor/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/SkillNerds/xskill.git --path skills/xskill-dev--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add SkillNerds/xskill --skill xskill-dev -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install SkillNerds/xskill xskill-dev --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/xskill-dev .gemini/skills/xskill-dev && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .gemini/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install SkillNerds/xskill xskill-devInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add SkillNerds/xskill --skill xskill-dev -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/xskill-dev .github/skills/xskill-dev && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .github/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SkillNerds/xskill --skill xskill-dev -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install SkillNerds/xskill xskill-dev --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SkillNerds/xskill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/xskill-dev .opencode/skills/xskill-dev && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "xskill-dev" agent skill from https://github.com/SkillNerds/xskill/tree/main/skills/xskill-dev into .opencode/skills/xskill-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xskill-dev", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
xskill-dev- GitHub stars
- 128
- Token cost
- ~422 tokens
- SKILL.md length
- 104 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
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…
- Developing xskill itself — editing agent tool docstrings
- SKILL.md covers 工具描述从哪来, 改完 docstring 必跑：dump_schema, 上下文预算的流式陷阱 and 相关材料
- Calls python
- Changing the generate agent tool surface
What it does
Xskill Dev is an agent skill from SkillNerds/xskill. Use 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 model. Covers the dumpschema workflow and where tool descriptions come from.
Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Technical documentation. The repository describes itself as: Self-evolving skills lib for coding agents. The licence is MIT.
When your agent uses it
- Developing xskill itself — editing agent tool docstrings
- Changing the generate agent tool surface
- Verifying what schema the Agno framework actually sends to the model
Example prompts
- “/xskill-dev”
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:
python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Xskill Dev loads about 422 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 104 words of instructions outside code blocks.
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). 104 words, ~422 tokens.
Download SKILL.mdSave it as
.claude/skills/xskill-dev/SKILL.md (or your agent's skills folder).- name
- xskill-dev
- description
- Use 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 model. Covers the dump_schema workflow and where tool descriptions come from.
Developing xskill
工具描述从哪来
Agno 框架直接把 @tool 装饰的 Python 函数 docstring 当作发给模型的工具描述，
参数说明也从 docstring 里解析。也就是说 docstring 就是模型上下文的一部分：
- 写给模型看，不写内部实现细节（内部细节放代码注释）。
- 系统提示词里不要再抄一遍工具清单，框架会自动注入 schema，抄了会漂移。
- generate 代理的轨迹工具在
src/xskill/agents/traj_tools.py， 通用工具在src/xskill/agents/agent_tools.py， wiki 工具在src/xskill/agents/llm_wiki.py。
改完 docstring 必跑：dump_schema
改任何工具的 docstring 或签名之后，跑一次导出脚本，看 Agno 实际生成的 schema 是什么样，确认模型看到的和你想的一致：
/home/admin/xskill/.venv/bin/python \
scratch/standalone-generate/tool_surface/dump_schema.py输出写在同目录 SCHEMA.txt。对照检查：
- 每个工具的 description 是否完整、有没有被截断或混进实现细节；
- 参数名、类型、必填项是否与函数签名一致；
- 新增或删除工具后，工具总数是否符合预期（generate 面当前是 16 个）。
SCHEMA.txt 可以进 code review diff，reviewer 能直接看到模型侧的变化。
上下文预算的流式陷阱
_wrap_with_context_mgmt 只包 model.invoke。任何用 stream=True 跑 agent
的路径都会走 invoke_stream，完全绕过 compact、spill 和超长兜底，模型跑在
后端原生窗口里（DeepSeek 是 1M），而且日志里一条 CONTEXT 事件都不会有。
产品 GenerateAgent 用非流式 agent.run() 所以没事；写实验脚本、demo、
新 agent 入口时必须非流式，或先给 invoke_stream 补包装。判断预算机制
是否真在跑，看 agent.log 里有没有 CONTEXT 事件（Compacted context、
Spilled、Compact was not needed 任意一种）。
llm_cfg 里开剪裁的键名是 enable_spill，不是 spill。
相关材料
- 工具面设计与取舍：
docs/plans/2026-08-27-generate-tool-surface.md - 独立实验台（Phoenix 观测、变体对比）：
scratch/standalone-generate/， 入口run_experiment.py，product变体加载产品 traj_tools 与产品 SYSTEM_PROMPT，是验证产品行为的首选变体。
© 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
Just SKILL.md in skills/xskill-dev of SkillNerds/xskill.
Open the folder on GitHubat commit aeee7c1
Compare with similar skills
Xskill Dev 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Xskill Dev this skillSkillNerds/xskill | 128 | — | ~422 | Automated safety check: Pass | MIT | |
| Diagram Designcathrynlavery/diagram-design | 45k | 1 repos | ~7.5k | Automated safety check: Pass | MIT | |
| Simple Englishmoeru-ai/airi | 50k | 2 repos | ~4.6k | Automated safety check: Pass | MIT | |
| Get API Docs with chubandrewyng/context-hub | 14k | 2 repos | ~775 | Automated safety check: Pass | MIT | |
| Doc SyncJetBrains/ideavim | 10k | 2 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Mailspring App ScreenshotsFoundry376/Mailspring | 18k | — | ~1.5k | Automated safety check: Pass | GPL-3.0 |
Similar skills
Simple English
moeru-ai/airi
Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.
Get API Docs with chub
andrewyng/context-hub
Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.
- Official
Doc Sync
JetBrains/ideavim
Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.
Mailspring App Screenshots
Foundry376/Mailspring
Captures screenshots of the running Mailspring dev app for docs, PRs or visual checks by launching it with a debugging port, driving the UI and clipping to an element.
Draw.io Diagram Studio
Agents365-ai/drawio-skill
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
More from SkillNerds/xskill
Using Xskill
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…
Xskill Helper
SkillNerds/xskill
A skill your agent uses for xskill. An agent skill from SkillNerds/xskill.
Xskill Registry DB First
SkillNerds/xskill
XSkill 数据访问原则：文件系统是内容真相，由 worker 同步进库；面板与业务读 请求只走数据库；内核 agent loop 可直接写盘。适用于改 dashboard、recommend、 team、pipeline、ecosystems 等读路径，以及审查是否又引入业务侧扫盘。
Related
Categories
Questions about Xskill Dev
What does Xskill Dev do?
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…. Xskill Dev is an agent skill from SkillNerds/xskill. Use 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 model.
When should I use Xskill Dev?
Xskill Dev fits situations like: developing xskill itself — editing agent tool docstrings; changing the generate agent tool surface; verifying what schema the Agno framework actually sends to the model.
How do I install Xskill Dev in Claude Code?
Run `npx skills add SkillNerds/xskill --skill xskill-dev -a claude-code`. Or copy the skill folder (skills/xskill-dev in SkillNerds/xskill) into .claude/skills/xskill-dev in your project. Claude Code loads it when a task matches its description.
How do I install Xskill Dev in Codex?
Run `npx skills add SkillNerds/xskill --skill xskill-dev -a codex`. Or copy the skill folder (skills/xskill-dev in SkillNerds/xskill) into .agents/skills/xskill-dev in your project. Codex loads it when a task matches its description.
Can I use Xskill Dev 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 xskill-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xskill-dev, .gemini/skills/xskill-dev, .github/skills/xskill-dev and .opencode/skills/xskill-dev in your project.
What does Xskill Dev need to run?
Going by SKILL.md and its folder, Xskill Dev needs the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Xskill Dev access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Xskill Dev 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 Xskill Dev use?
Xskill Dev 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 Xskill Dev use?
About 422 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Xskill Dev?
Skills that share tags, products or a category with Xskill Dev: Diagram Design (cathrynlavery/diagram-design, 45k stars), Simple English (moeru-ai/airi, 50k stars), Get API Docs with chub (andrewyng/context-hub, 14k stars) and Doc Sync (JetBrains/ideavim, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Xskill Dev?
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.