Community编程与开发github.com

flc1125/docs

`mote` 技能教导 AI 代理 **何时以及如何** 使用 Mote 发布 Markdown — 它本身不包含上传实现(而是驱动 CLI 或 MCP 工具)。

docs 是什么?

`mote` 技能是一个轻量级的 AI 代理指令集合,用于指导 Claude Code、Cursor 等代理通过 Mote 平台将 Markdown 文档发布为可共享的 URL。该技能本身不包含任何上传逻辑,而是依赖于外部工具(如 mote-cli 或 Mote MCP 服务器)来执行实际的上传操作。安装后,当用户要求“发布 Markdown 在线”或“创建可分享链接”时,代理会按照明确的步骤操作:检查本地图片、选择配置的发布路径、上传内容并返回结果 URL。该技能还内置了安全护栏,例如禁止发布凭据或密钥、遵守大小限制并如实报告错误。它支持多种安装方式,包括非交互式 CI 安装,并附带用于 Codex 的显示元数据和品牌图标,确保跨平台的一致体验。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/flc1125/mote/tree/main/docs

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 的代理将:

  1. 检查本地图片并选择配置的发布路径。publish_markdown 接受文本和远程图片 URL;本地图片需要 CLI 或本地 publish_markdown_file,路径相对于 Markdown 文件解析。
  2. 发布并解析结果
  3. 直接返回 URL

它还编码了安全护栏:绝不发布凭据/密钥(Mote URL 是能力令牌,且文档是不可变的),遵守大小限制,并如实报告错误。

单独的阅读、编辑或预览本地文档不会触发发布。指向其他本地文档的链接不会自动发布这些文档。 对于公式、图表和其他扩展,请参阅兼容性参考 和现场示例。即使发布成功,不支持的语法也可以保留为可读源代码。

要求

技能本身只是指令 — 发布仍需要:

  • mote-cli 包或源码构建,配以显式的认证配置或有效的 Mote OAuth 登录(请参阅 CLI 参考 和认证)。自托管用户应保持其预期的实例配置,或
  • 连接 Mote MCP 服务器(请参阅 MCP 指南)

只有本地服务器暴露 publish_markdown_file。认证失败必须向用户报告;技能不会创建凭据、未经授权启动浏览器登录、读取另一个客户端的钥匙串或切换到旧令牌。显式的登录协助请求可以在用户授权的范围内处理。在解决超时或未知结果之前,不要重复发布而不确认是否成功。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能