Mote 技能
mote 技能教导 AI 代理 何时以及如何 使用 Mote 发布 Markdown — 它本身不包含上传实现(而是驱动 CLI 或 MCP 工具)。
可以通过 skills 生态系统 CLI 安装技能。
安装
npx skills add flc1125/mote
有用的变体:
# 预览仓库提供的内容
npx skills add flc1125/mote --list
# 安装到特定代理
npx skills add flc1125/mote -a claude-code -a codex
# 非交互式(CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y
该技能位于本仓库的 skills/mote/SKILL.md 处。
它包含在 agents/openai.yaml 中的 Codex 显示元数据以及打包在 assets/ 中的 Mote 图标,
因此当仅安装技能目录时,品牌信息仍然可用。其他客户端可以仅使用 SKILL.md 而无需这些可选的 UI 元数据。
品牌素材维护在 docs/assets 中;修改后请运行 node scripts/brand/sync.mjs。
现有的品牌检查也会验证技能图标的副本。
功能
安装后,被要求在线发布 Markdown 或创建可分享 URL 的代理将:
- 检查本地图片并选择配置的发布路径。
publish_markdown接受文本和远程图片 URL;本地图片需要 CLI 或本地publish_markdown_file,路径相对于 Markdown 文件解析。 - 发布并解析结果
- 直接返回 URL
它还编码了安全护栏:绝不发布凭据/密钥(Mote URL 是能力令牌,且文档是不可变的),遵守大小限制,并如实报告错误。
单独的阅读、编辑或预览本地文档不会触发发布。指向其他本地文档的链接不会自动发布这些文档。 对于公式、图表和其他扩展,请参阅兼容性参考 和现场示例。即使发布成功,不支持的语法也可以保留为可读源代码。
要求
技能本身只是指令 — 发布仍需要:
- mote-cli 包或源码构建,配以显式的认证配置或有效的 Mote OAuth 登录(请参阅 CLI 参考 和认证)。自托管用户应保持其预期的实例配置,或
- 连接 Mote MCP 服务器(请参阅 MCP 指南)
只有本地服务器暴露 publish_markdown_file。认证失败必须向用户报告;技能不会创建凭据、未经授权启动浏览器登录、读取另一个客户端的钥匙串或切换到旧令牌。显式的登录协助请求可以在用户授权的范围内处理。在解决超时或未知结果之前,不要重复发布而不确认是否成功。