add-mcp SKILL.md skillB

add-mcp from riot-org/riot is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add riot-org/riot/add-mcp@git:20261014.9c3854a

Pins git:20261014.9c3854a in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
riot-org/riot
Path
crates/riot-kernel/builtin/skills/add-mcp/SKILL.md
Versions recorded
1
Latest version
git:20261014.9c3854a, committed Oct 14, 2026
Size
10,313 bytes
Repository stars
22
License
a license file GitHub does not identify

用户想加、改、排查 MCP 服务器,或从 Cursor / Claude Desktop / VS Code 搬 MCP 配置过来时用。用户级只认 stdio(远程走 mcp-remote 桥)、config.json 的形状、ReloadConfig 验证和常见连不上的原因。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# MCP 服务器

MCP 不是 `.riot/` 下的文件,也没有项目级。配置在**设置 → MCP**,落在
`<配置目录>/config.json` 的 `mcpServers` 数组。应用只在启动和设置页保存
时读这个文件:你直接改了它,**必须调 `ReloadConfig` 工具**才会生效,否则
要等重启,而且用户下次在设置页保存时会被旧配置整份覆盖掉。连接是应用级
的(所有会话共用同一批进程),工具每轮快照,连上之后的下一轮才进清单。
`ReloadConfig` 连上了新工具时,结果里会让你收尾:照做,用一句话结束本轮,
Riot 会自动用新清单续一轮,不用请用户再发「继续」。

设置页 JSON 视图认 Claude Desktop / Cursor / Cline / VS Code 的通用形状,
保存是**整体替换**当前列表。根形状认三种:`{"mcpServers":{…}}`、
`{"servers":{…}}`(VS Code)、不带包装的裸映射。只贴内层
`{"command":"npx"}` 会报「每个服务器要有名字」。

## 参数(用户级只认这些)

| 字段 | 要不要 | 含义 |
| --- | --- | --- |
| (对象的键) | 必填 | 变成服务器 id。字母数字、`-`、`_` 以外的字符导入时换成 `-` |
| `command` | 必填 | **单个 token**:`npx` / `uvx` / 可执行文件路径。别把参数写进来 |
| `args` | 可选 | 字符串数组,每个元素一个参数 |
| `env` | 可选 | 对象。密钥和服务器要读的变量写这里,进 `config.json`(不是 `auth.json`)。设置 → 环境变量里的值**不会**传给 MCP 服务器 |
| `disabled` | 可选 | `true` = 不启动。表单里对应「启用」开关(`enabled`) |

表单比 JSON 多两个 Riot 自己的字段:`name`(显示名,空 = 显示 id;标准
格式没有,导出丢、导入按 id 捡回)、`enabled`(和 `disabled` 反着)。
表单里 `args` 一行一个、`env` 一行一个 `KEY=VALUE`。

不认、写了会怎样:

- **`url` / `serverUrl`,或 `type` / `transport` 为 `http` / `sse` /
  `streamable-http`** → 整段拒掉,报「暂不支持远程」。Cursor 那种
  `{"url":"https://…","headers":{…}}` 不能原样贴,见下面「远程」。
- `type: "stdio"` 可以写,等于没写。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add riot-org/riot/add-mcp@sha256:25ddaf258f31058c

The line at the top of this page pins the label git:20261014.9c3854a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wvtcvfdmnwvcia72.svg)](https://markdownregistry.com/a/art_wvtcvfdmnwvcia72)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 14, 2026.

versioncommittedcommitsizeaudit
git:20261014.9c3854a latest2026-10-14 9c3854a 10,313 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8080)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10313 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

riot-org/riot · 22 stars · license a license file GitHub does not identify · pushed 2026-10-29 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_wvtcvfdmnwvcia72
GET https://markdownregistry.com/api/v1/resolve?ref=riot-org/riot/add-mcp
GET https://markdownregistry.com/api/v1/blob/25ddaf258f31058cc7dbb588300ac68b9b0a174987ad70ebd021bb071ee9119c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from riot-org/riot

add-command SKILL.md skill
riot-org/riot · .riot/skills/add-command/SKILL.md · 给前端加一个 Tauri 命令时用。要改五处,漏了其中三处只表现为运行时「command not found」;权限文件还有个先后顺序的坑会让 build.rs 直接 panic。
git:20260817.d00a470 · audit A · 22 stars
add-tool SKILL.md skill
riot-org/riot · .riot/skills/add-tool/SKILL.md · 给 Riot 加一个模型能调的工具时用。Tool trait 的必答项、fail-closed 默认值的判据、注册位置、以及几条写错了不报错只是行为悄悄降级的规则。
git:20261011.281dcd7 · audit A · 22 stars
commit-batch SKILL.md skill
riot-org/riot · .riot/skills/commit-batch/SKILL.md · 工作区堆了多个不相关主题的改动、要整理成提交时用。按主题切分而不是拆成一堆小提交,并照这个仓库的消息风格写。
git:20260817.d00a470 · audit A · 22 stars
mutate SKILL.md skill
riot-org/riot · .riot/skills/mutate/SKILL.md · 动过权限决策链、Bash 分析、路径围栏、安全检查、文件工具或进程执行器之后用。跑变异测试,并正确解读存活的变异。
git:20260817.d00a470 · audit A · 22 stars
protocol-change SKILL.md skill
riot-org/riot · .riot/skills/protocol-change/SKILL.md · 改了 crates/riot-protocol 里的类型之后用。重新生成绑定,并检查 serde tag 撞名这类 Rust 类型层面看不出来的问题。
git:20260817.d00a470 · audit A · 22 stars
review SKILL.md skill
riot-org/riot · .riot/skills/review/SKILL.md · 审查一批改动时用。缺陷优先,并按这个仓库特有的失效方式去找问题——那些编译通过、类型正确、看起来合理的写法。
git:20260817.d00a470 · audit A · 22 stars
verify SKILL.md skill
riot-org/riot · .riot/skills/verify/SKILL.md · 改完代码要验证时用。按这个仓库的分层防线依次跑,并说明每一层拦的是什么。别只跑 cargo build 就当验证过了。
git:20260817.d00a470 · audit A · 22 stars
commit SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/commit/SKILL.md · 要把改动提交成 git commit 时用。先看清工作区里有几件事、按主题分组、只暂存这一组,以及消息里该写什么不该写什么。
git:20261014.9c3854a · audit A · 22 stars
create-plugin SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/create-plugin/SKILL.md · 用户想写一个 Riot 插件、把已有的技能/命令/hooks/MCP 打包分发、或把 Claude Code / Cursor 插件搬到 Riot 时用。目录布局、三种清单格式、dev.riot 扩展字段、本地链接调试流程和市场发布。
git:20261014.9c3854a · audit A · 22 stars
debug SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/debug/SKILL.md · 排查 bug 时用。顺序是硬的:先复现、再让证据淘汰假设、修根因、用原始复现路径验证。不要看到第一个可疑点就动手改。
git:20260817.d4dfa41 · audit A · 22 stars
extend-riot SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/extend-riot/SKILL.md · 用户想加技能、斜杠命令、hook、项目约定(AGENTS.md),或要给命令配 API key、密码这类机密时用。各扩展点的目录、格式限制和优先级规则。MCP 服务器转 add-mcp,打成可分发的插件转 create-plugin。
git:20261014.9c3854a · audit B · 22 stars
retro SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/retro/SKILL.md · 任务磕磕碰碰才做成、被纠正了好几次之后用;用户说「复盘」「总结经验」「记下来」时也用。回顾这次会话的纠错轨迹,筛出下次还会犯的错,沉淀进 AGENTS.md 或技能,同类任务下次不用再教一遍。
git:20261014.9c3854a · audit A · 22 stars

Every file in riot-org/riot

Browse by kind, by grade B, or by owner.