Agent skill

xProtocol Module Maintainer

by x-tools-author in x-tools-author/x-tools

Guides edits to the xProtocol module in xTools, a custom protocol serializer and parser, covering protocol definitions, message editing, sending and parsing.

LGPL-3.0Auto-check passedDevelopment

SKILL.md written in Chinese; this summary is our English description.

Install xProtocol Module Maintainer

skills CLI
$ npx skills add x-tools-author/x-tools --skill x-protocol -a claude-code

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

GitHub CLI
$ gh skill install x-tools-author/x-tools x-protocol --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/x-tools-author/x-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/x-protocol .claude/skills/x-protocol && 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
x-protocol
GitHub stars
1.1k
Token cost
~369 tokens
SKILL.md length
30 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Guides edits to the xProtocol module in xTools, a custom protocol serializer and parser, covering protocol definitions, message editing, sending and parsing.

  • Works in 6 steps: 阅读协议工具需求文档,理解协议工具的功能范围和用户需求。 → 阅读协议工具模块代码,理解各个文件的功能和相互关系。 → 根据用户的具体需求,定位需要修改的功能模块和相关代码文件。 → …
  • Changing the protocol definition in xTools
  • SKILL.md covers 需求文档, 模块代码, 特别说明 and 执行步骤, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

xProtocol lets users define their own protocol format, control how messages are sent and parse what is received, with support for JSON messages and binary payloads. The skill applies when someone asks to change a protocol definition, edit message content, send a message or parse a received one. The SKILL.md is written in Chinese.

The agent reads the requirements document and the module code under src/private/protocol/protocol, which holds files such as protocolcommon.cpp and its header, then changes only code inside that directory. After editing it compiles and tests, and uses the build-xtools skill to confirm xTools still builds. If the requirements document cannot be found, it stops and asks you for a link. Code comments are written in English.

When your agent uses it

  • Changing the protocol definition in xTools
  • Editing the content of protocol messages
  • Fixing how xProtocol sends or parses messages
  • Working on JSON or binary message payload handling in the module

Example prompts

  • “Add a checksum field to the xProtocol message definition.”
  • “Fix the parser so binary payloads are read correctly when they follow a long header.”
  • “Update the protocol sending logic and verify it builds with build-xtools.”

Requirements

  • The xTools repository with its requirements readme
  • The build-xtools skill for compile checks

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 阅读协议工具需求文档,理解协议工具的功能范围和用户需求。
  2. 阅读协议工具模块代码,理解各个文件的功能和相互关系。
  3. 根据用户的具体需求,定位需要修改的功能模块和相关代码文件。
  4. 在协议工具模块内进行代码修改,确保修改符合项目的编码规范和风格。
  5. 修改完成后,进行编译和测试,确保修改的功能正常工作且没有引入新的问题。
  6. 使用 'build-xtools' 技能构建 xTools,验证修改后的协议工具功能是否通过编译。

What it can do on your machine

Read from SKILL.md and the folder at commit 6214c41. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

xProtocol Module Maintainer loads about 369 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 30 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~369

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 x-tools-author/x-tools at commit 6214c41, republished under its LGPL-3.0 licence (© x-tools-author). 30 words, ~369 tokens.

Download SKILL.mdSave it as .claude/skills/x-protocol/SKILL.md (or your agent's skills folder).
name
x-protocol
description
xProtocol是一个自定义协议序列化/反序列化工具,用户可以编辑自己的协议格式,可以控制消息的发送,可以解析接收到的消息。支持json格式的消息和二进制格式的消息体(负载)。用户要求修改协议定义、编辑消息内容、发送消息或解析接收消息时使用此技能。

xProtocol协议工具

xProtocol是一个自定义协议序列化/反序列化工具,用户可以编辑自己的协议格式,可以控制消息的发送,可以解析接收到的消息。支持json格式的消息和二进制格式的消息体(负载)。当用户要求修改协议定义、编辑消息内容、发送消息或解析接收消息时使用此技能。

需求文档

详见 协议工具需求文档;如果你无法找到此文档,终止技能执行并提示用户提供需求文档链接。

模块代码

协议工具的核心代码位于 src/private/protocol/protocol 目录下,主要包含以下文件:

txt
./protocol
├── protocolcommon.cpp            // 协议工具公共函数实现
├── protocolcommon.h              // 协议工具公共函数声明,如数据类型转换、校验函数等
├── protocolmessageview.cpp       // 消息视图实现
├── protocolmessageview.h         // 消息视图类声明(消息负载的解析显示/用户交互)
├── protocolmessageview.ui        // 消息视图设计文件
├── protocolpropertyview.cpp      // 协议属性视图实现
├── protocolpropertyview.h        // 协议属性视图类声明
├── protocoltreefilter.cpp        // 协议树过滤器实现
├── protocoltreefilter.h          // 协议树过滤器类声明
├── protocoltreemodel.cpp         // 协议树模型实现
├── protocoltreemodel.h           // 协议树模型类声明
├── protocoltreeview.cpp          // 协议树视图实现
├── protocoltreeview.h            // 协议树视图类声明
└── readme.md                     // 协议工具功能需求文档

特别说明

你不能修改模块外的任何代码,只能修改此目录下的代码。

执行步骤

  1. 阅读协议工具需求文档,理解协议工具的功能范围和用户需求。
  2. 阅读协议工具模块代码,理解各个文件的功能和相互关系。
  3. 根据用户的具体需求,定位需要修改的功能模块和相关代码文件。
  4. 在协议工具模块内进行代码修改,确保修改符合项目的编码规范和风格。
  5. 修改完成后,进行编译和测试,确保修改的功能正常工作且没有引入新的问题。
  6. 使用 'build-xtools' 技能构建 xTools,验证修改后的协议工具功能是否通过编译。

其它说明

  • 如果生成代码附带注释,注释要使用英文。
  • 生成代码要符合项目的编码规范和风格。

© x-tools-author, LGPL-3.0. 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 .github/skills/x-protocol of x-tools-author/x-tools.

Open the folder on GitHubat commit 6214c41

Compare with similar skills

xProtocol Module Maintainer 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.

xProtocol Module Maintainer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
xProtocol Module Maintainer this skillx-tools-author/x-tools1.1k—~369Automated safety check: PassLGPL-3.0
YugabyteDB ASH Instrumentationyugabyte/yugabyte-db11k—~4.5kAutomated safety check: PassCustom licence
pybind11 Release Preparationpybind/pybind1118k—~1.7kAutomated safety check: PassCustom licence
Qt Cpp ReviewSerial-Studio/Serial-Studio7.2k—~4.3kAutomated safety check: PassCustom licence
Paddle Eager GraphPaddlePaddle/Paddle24k—~562Automated safety check: PassApache-2.0
ONNX Runtime Source Buildmicrosoft/onnxruntime22k—~1.4kAutomated safety check: PassMIT

Similar skills

  • YugabyteDB ASH Instrumentation

    yugabyte/yugabyte-db

    Procedure for adding or changing YugabyteDB Active Session History wait states in TServer and DocDB C++ code, including the macro to use for sync and async paths.

    11k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens the pybind11 release-preparation pull request: picking the release base, bumping the version in common.h and integrating the changelog, following docs/release.rst.

    18k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Qt Cpp Review

    Serial-Studio/Serial-Studio

    Qt6/C++ deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.

    7.2k GitHub stars~4.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Paddle Eager Graph

    PaddlePaddle/Paddle

    A skill your agent uses when navigating Paddle eager-mode (dynamic graph) source code, tracing forward/backward execution, debugging autograd issues, understanding PyLayer, or investigating…

    24k GitHub stars~562 tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • ONNX Runtime Source Build

    microsoft/onnxruntime

    Official

    Builds ONNX Runtime from source with its build scripts, explaining the update, build and test phases, key flags and where the build output lands.

    22k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Esp32 Firmware Engineer

    alxv2016/folloup-sticky

    ESP32 firmware engineering for ESP-IDF projects. An agent skill from alxv2016/folloup-sticky.

    116 GitHub starsUsed in 1 repo~3.8k tokens
    DevelopmentAuto-check passed

More from x-tools-author/x-tools

All 10 skills in this repo
  • Qt C++ Code Review

    x-tools-author/x-tools

    Read-only review of Qt6 C++ code that combines a deterministic lint script with six parallel analysis agents and reports only high-confidence issues.

    1.1k GitHub starsUsed in 2 repos~4.3k tokens
    Auto-check passed
  • Qt6 QML Code Reviewer

    x-tools-author/x-tools

    Runs a 47-rule deterministic QML linter, then six parallel deep-analysis passes over bindings, layout, loaders, delegates, states, and performance.

    1.1k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • QML Reference Documentation

    x-tools-author/x-tools

    Generates standalone Markdown reference docs for QML components and Qt Quick applications from .qml source and related C++ and build files, one file per component.

    1.1k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Qt QML Profiler

    x-tools-author/x-tools

    Finds what is making a Qt Quick interface stutter or drop frames by capturing a profiler trace and tracing the slow spots back to the QML source.

    1.1k GitHub starsUsed in 1 repo~5.2k tokens
    Auto-check passed
  • Qt C++ Reference Docs

    x-tools-author/x-tools

    Generates standalone Markdown reference docs for Qt and plain C++ source files, from Widgets and Quick classes to utility headers and main.cpp, as prose and tables.

    1.1k GitHub starsUsed in 1 repo~6.2k tokens
    Auto-check passed
  • QML Coding Best Practices

    x-tools-author/x-tools

    Applies QML best practices when writing, reviewing, refactoring or debugging QML code, with Qt 5 and Qt 6 import rules and concise, rule-silent output.

    1.1k GitHub starsUsed in 1 repo~3.4k tokens
    Auto-check passed

Works with

Categories

Questions about xProtocol Module Maintainer

What does xProtocol Module Maintainer do?

Guides edits to the xProtocol module in xTools, a custom protocol serializer and parser, covering protocol definitions, message editing, sending and parsing. xProtocol lets users define their own protocol format, control how messages are sent and parse what is received, with support for JSON messages and binary payloads. The skill applies when someone asks to change a protocol definition, edit message content, send a message or parse a received one.

When should I use xProtocol Module Maintainer?

xProtocol Module Maintainer fits situations like: changing the protocol definition in xTools; editing the content of protocol messages; fixing how xProtocol sends or parses messages; working on JSON or binary message payload handling in the module.

How do I install xProtocol Module Maintainer in Claude Code?

Run `npx skills add x-tools-author/x-tools --skill x-protocol -a claude-code`. Or copy the skill folder (.github/skills/x-protocol in x-tools-author/x-tools) into .claude/skills/x-protocol in your project. Claude Code loads it when a task matches its description.

How do I install xProtocol Module Maintainer in Codex?

Run `npx skills add x-tools-author/x-tools --skill x-protocol -a codex`. Or copy the skill folder (.github/skills/x-protocol in x-tools-author/x-tools) into .agents/skills/x-protocol in your project. Codex loads it when a task matches its description.

Can I use xProtocol Module Maintainer 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 x-tools-author/x-tools --skill x-protocol -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-protocol, .gemini/skills/x-protocol, .github/skills/x-protocol and .opencode/skills/x-protocol in your project.

What does xProtocol Module Maintainer need to run?

SKILL.md names no scripts, command-line tools or credentials: xProtocol Module Maintainer is instructions for the agent only. Our summary lists: The xTools repository with its requirements readme; The build-xtools skill for compile checks.

Does xProtocol Module Maintainer 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 xProtocol Module Maintainer 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 xProtocol Module Maintainer use?

xProtocol Module Maintainer is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does xProtocol Module Maintainer use?

About 369 tokens (SKILL.md is roughly 1.5k 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 xProtocol Module Maintainer?

Skills that share tags, products or a category with xProtocol Module Maintainer: YugabyteDB ASH Instrumentation (yugabyte/yugabyte-db, 11k stars), pybind11 Release Preparation (pybind/pybind11, 18k stars), Qt Cpp Review (Serial-Studio/Serial-Studio, 7.2k stars) and Paddle Eager Graph (PaddlePaddle/Paddle, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains xProtocol Module Maintainer?

x-tools-author (a GitHub user) maintains it in x-tools-author/x-tools, which has 1,090 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 3, 2026.

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