Community程式設計與開發github.com

flc1125/mote

`mote` 技能教導 AI 代理程式 **何時以及如何** 使用 Mote 發布 Markdown——它本身不包含上傳實作(而是驅動 CLI 或 MCP 工具)。

mote 是什麼?

此技能教導 AI 代理程式使用 Mote 發布 Markdown 內容,但不包含具體的上傳實作,而是依賴 CLI 或 MCP 工具來執行。它定義了何時觸發布、如何處理本地圖片以及如何解析發布結果。技能支援透過 `npx skills add flc1125/mote` 安裝,並且可以為特定代理程式(如 Claude Code、Codex)安裝。它還內建了護欄:絕不發布憑證或機密,尊重大小限制,並如實報告錯誤。此技能適合需要讓 AI 代理程式安全、一致地發布 Markdown 的開發者。

相容平台✓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 圖示, 因此即使只安裝技能目錄,品牌標識仍然可用。 其他客戶端可以在沒有此可選 UI 元數據的情況下使用 SKILL.md。 品牌素材維護在 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.

相關技能