extend-riot SKILL.md skillB

extend-riot 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/extend-riot@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/extend-riot/SKILL.md
Versions recorded
4
Latest version
git:20261014.9c3854a, committed Oct 14, 2026
First version recorded
Aug 17, 2026
Size
10,634 bytes
Repository stars
22
License
a license file GitHub does not identify

用户想加技能、斜杠命令、hook、项目约定(AGENTS.md),或要给命令配 API key、密码这类机密时用。各扩展点的目录、格式限制和优先级规则。MCP 服务器转 add-mcp,打成可分发的插件转 create-plugin。.

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

# 扩展 Riot

技能、命令、hook 是普通文件,改完**下一轮对话生效**,不用重启。AGENTS.md
只在会话第一条消息注入,改完要**新开会话**才看得到。MCP 服务器在
`config.json` 里,规矩不同,用 `add-mcp` 技能。

全局的放配置目录(`<配置目录>`),项目级的放 `<项目>/.riot/`。同名时
**项目级赢**(和 git 的 local > global 同一直觉)。`<配置目录>` 是:

- 设了 `XDG_CONFIG_HOME`(任何平台,含登录 shell 里 export 的)→
  `$XDG_CONFIG_HOME/riot`
- 否则 macOS `~/Library/Application Support/riot`、Linux `~/.config/riot`、
  Windows `%APPDATA%\riot`

拿不准就 `echo $XDG_CONFIG_HOME` 看一眼,或让用户到设置 → 关于里看。

放哪一层:只给用户自己用、跨项目通用的放全局;跟这个仓库走、要提交给
团队的放项目级。用户没说就问,别替用户选。

写 `<项目>/.riot/` 下的文件会弹「修改 agent 配置」的确认,「全部放行」也
跳不过,每次写都弹。动手前跟用户说一声这是正常的,免得被当成异常点了拒绝。

插件带的技能和命令排在全局之后、内置之前,且自动带 `<插件>:` 前缀 —— 要
把这些东西打包给别人装、或从 Claude Code / Cursor 的插件里搬过来,用
`create-plugin` 技能。

## 技能 SKILL.md

```text
<配置目录>/skills/<名字>/SKILL.md     全局
<项目>/.riot/skills/<名字>/SKILL.md   项目级
```

```markdown
---
name: verify
description: 改完代码要验证时用。按分层防线依次跑。
disable-model-invocation: false
---
正文。可用 $ARGUMENTS 和 ${SKILL_DIR}。
```

限制(这些都是模型猜不到的):

- **frontmatter 必须有**(和命令不同):不以 `---` 开头、或正文为空,都算
  「有问题的技能」报给设置页。`name` 可省,省了取目录名。
- **`description` 必填**,缺了不静默跳过,同样报给设置页。
  它是模型决定要不要加载的唯一依据。
- **`description` 硬顶 250 字符**。超了会被截断,模型就是在残句上做判断。
  写不下就说清「什么时候用」,别写做法——做法在正文里。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add riot-org/riot/extend-riot@sha256:afe0ca10ac381a45

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_lgtawaxynpcz52ce.svg)](https://markdownregistry.com/a/art_lgtawaxynpcz52ce)

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

Versions

The registry has recorded 4 versions of this file, between Aug 17, 2026 and Oct 14, 2026, about one every 19 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20261014.9c3854a latest2026-10-14 9c3854a 10,634 BB view · diff
git:20260913.5e905fe2026-09-13 5e905fe 6,344 BA view · diff
git:20260909.c229f9f2026-09-09 c229f9f 6,070 BA view · diff
git:20260817.d4dfa412026-08-17 d4dfa41 5,906 BA 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 instruction to read or print local credentials (matched: cat .env)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10634 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 base64 blob over 200 characters
  • pass: No link to a raw IP address
  • 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_lgtawaxynpcz52ce
GET https://markdownregistry.com/api/v1/resolve?ref=riot-org/riot/extend-riot
GET https://markdownregistry.com/api/v1/blob/afe0ca10ac381a4504c5481d662602a4aa46e7c327418405a71c8ffa12a46f90

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
add-mcp SKILL.md skill
riot-org/riot · crates/riot-kernel/builtin/skills/add-mcp/SKILL.md · 用户想加、改、排查 MCP 服务器,或从 Cursor / Claude Desktop / VS Code 搬 MCP 配置过来时用。用户级只认 stdio(远程走 mcp-remote 桥)、config.json…
git:20261014.9c3854a · audit B · 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
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.