MCPInstall

ray-obsidian

by imraywangProductivity & Automation

新建、检查或适配面向内容生产的 Obsidian 知识库结构（资料、知识、选题、写作、发布、回流）。用于“搭一个 Obsidian 知识库”“把 vault 接入内容管线”“检查知识库结构”，或 ray-writer 找不到知识库时。只补缺失结构，不动已有笔记。

Installs
60
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/imraywang/rayskills --skill ray-obsidian
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads ray-obsidian automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Ray Obsidian

把内容生产的地基装进用户自己的本地目录。先确定知识库根目录，再审计、初始化和复核；已有库只做增量补齐。

固定原则

  1. 不默认使用 rays-brain，也不假设知识库位于 iCloud、用户主目录或当前项目。
  2. 原始资料、长期知识、创作过程和发布成品分开保存；链接表达关系，目录表达职责。
  3. 用户已有文件优先。不得覆盖同名文件，不得自动移动、改名、删除或批量改 frontmatter。
  4. 不修改 .obsidian/，不强制插件、同步服务、Git 或特定云盘。Obsidian 只是编辑器，普通 Markdown 工具同样能使用这套结构。
  5. 初始化只建立最小可用骨架。采集自动化、网页剪藏、X 数据和发布连接器在用户需要时另行配置。
  6. 初始化后必须执行检查；目录存在不等于知识库可用。

1. 确定知识库根目录

按以下顺序定位：

  1. 用户明确给出的目录。
  2. 当前目录或父目录中的 .ray-obsidian.json。
  3. 当前目录或父目录中同时存在 10-创作/、20-知识/、30-资料/、50-系统/ 的兼容知识库。
  4. 仍无法确定时，只问一个问题：知识库要建在哪个本地目录？

路径确定后先报告绝对路径。不要把一个普通项目目录误当知识库，也不要因为目录名含 brain、notes 或 vault 就直接写入。

2. 先检查，后初始化

使用 Skill 加载时报告的根目录运行：

python3 <skill-base>/scripts/vault_setup.py check --vault <知识库目录>

检查结果为 ready 时直接交付；为 incomplete 或 missing 时，阅读 vault-schema.md，向用户简要说明将新增哪些目录和模板。已知的 ray-content-v1 会标记为可升级，按增量初始化补齐现行结构；未知版本仍然停止。

对已有 Obsidian 库，额外阅读 migration.md。只做兼容层增量初始化，不整理旧笔记。

3. 安全初始化

先预演：

python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称> --dry-run

确认目标没有跑偏后执行：

python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称>

脚本只会：

  • 创建缺失目录。
  • 从 assets/vault-template/ 复制缺失的说明、流程和模板。
  • 新建 .ray-obsidian.json 供其他 Ray Skill 发现结构版本。
  • 保留所有已存在的文件并在结果中列为 preserved。

出现同名文件时以用户文件为准。已知的 ray-content-v1 只升级 manifest、补齐缺失结构并保留全部旧目录和文件；若现有 manifest 无法解析或声明了未知结构版本，停止并报告，不覆盖修复。

4. 复核真实结果

初始化后重新执行 check，并实际读取：

  • HOME.md
  • 00-入口/10-工作台/知识工作台.md
  • 00-入口/10-工作台/创作工作台.md
  • 50-系统/30-模板/内容成稿包.md
  • 50-系统/30-模板/快速口播母稿.md
  • 50-系统/20-流程/个人知识库工作流.md

完成状态必须是 ready，且脚本报告没有覆盖文件。用户只要求检查时不得借机初始化。

5. 交接内容生产

向用户交付知识库绝对路径，并说明三个最小入口：

  • 新资料进入 30-资料/，自己的即时想法进入 10-创作/10-灵感/inbox.md。
  • 值得表达的角度先进入 10-创作/10-灵感/20-候选选题/；确认本次角度后，才在 10-创作/20-写作任务/ 建立成稿包。
  • 图文母稿进入 10-创作/30-文章草稿/；直接以口播起稿时使用 50-系统/30-模板/快速口播母稿.md，唯一母稿进入 10-创作/25-口播草稿/；确认发布后才进入 40-发布/，并在 40-发布/00-内容反馈/ 复盘。

用户接着要求写文章时，把知识库根目录、材料路径和目标平台交给 ray-writer。不要复制整套知识库到 Skill 目录，也不要把用户笔记吸收成 Skill 样本。

完成标准

  • 根目录由用户或可验证结构确定，没有靠目录名猜测。
  • 初始化前完成预演；已有文件零覆盖、零移动、零删除。
  • manifest、目录和核心模板齐全，最终检查为 ready。
  • 用户知道如何在 Obsidian 中打开该目录，以及如何从资料进入成稿包和草稿。

FAQ

What does the ray-obsidian skill do?

新建、检查或适配面向内容生产的 Obsidian 知识库结构（资料、知识、选题、写作、发布、回流）。用于“搭一个 Obsidian 知识库”“把 vault 接入内容管线”“检查知识库结构”，或 ray-writer 找不到知识库时。只补缺失结构，不动已有笔记。

How do I install ray-obsidian?

Run npx skills add https://github.com/imraywang/rayskills --skill ray-obsidian in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ray-obsidian/ (personal) or .claude/skills/ray-obsidian/ (project).

Which AI agents can use ray-obsidian?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ray-obsidian safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ray-obsidian?

It is published by imraywang in imraywang/rayskills. It has 60 recorded installs.

More from imraywang/rayskills

View all →

ray

imraywang/rayskills

rayskills 总入口：不确定该用哪个 ray- skill、只丢来一个真实任务，或要把内容从 idea 一路做到草稿箱或口播稿时使用，判断下一步或执行已确认的生产链。“推送”“走完整流程”不等于发布授权。触发：/ray。

62 installs

ray-writer

imraywang/rayskills

把灵感、剪藏、调研或草稿写成有 Ray 态度的中文长文（公众号 / X 长文），接入知识库的成稿与发布流程；也做带授权署名的译介稿。用于“写成文章”“写一篇公众号或 X 长文”“重写这篇”“翻译转载”。改口播转 ray-kb；不发布。

Docs & Writing61 installs

ray-cover

imraywang/rayskills

给定稿的文章或视频做带中文标题的封面：文章封面（公众号 2.33:1、X 16:9、X Article 5:2）用 Punk 风格库（MIT 版）；视频封面（默认只出 3:4、默认小Lin风A；要时出 9:16 竖屏和 16:9 横屏）用 Ray 真人照片 + 大标题。都按 Ray 的黑白灰 + 墨绿 IP 编译提示词，默认用 OpenAI 图像 API 分平台生成（也可退回 Codex CLI 调 Image 2），能只改局部不重画。用于“做封面”“视频封面”“竖屏封面”“横屏封面”“换个风格再出一版”“封面标题改一下”。不做正文配图和视频画面。

Backend & APIs60 installs

ray-x-article

imraywang/rayskills

把完成的长文和 5:2 封面写进已登录的 X Articles 后台存为草稿，核对预览并把草稿地址回写知识库。用于“放进 X 后台”“存为 X Article 草稿”“推送到 X”。只存草稿：不点 Publish，不重复建同题草稿。

Docs & Writing60 installs

ray-wechat

imraywang/rayskills

把定稿长文排成手机友好的公众号富文本并生成预览；Ray 明确同意后写入或更新公众号草稿箱并回读核对。用于“公众号排版”“推到公众号草稿箱”“更新微信草稿”。含糊说法先只做预览；不发布、不群发。

59 installs

ray-broll

imraywang/rayskills

把口播文稿、观点句或一个完整选题做成编辑隐喻拼贴风格的视频（黑白半调剪贴 + 平坦色场 + 从空场逐件组装的定格动画）。两种模式：单句 5 秒 B-roll（单条或批量），以及 beat map 驱动的 45–60 秒完整讲解片（含旁白 TTS、内容感知变速、字幕与拼装）。用户说“拼贴 b-roll”“纸拼贴视频”“vox 那种风格的视频”“半调拼贴动画”“给这句口播配画面”“把这个选题做成拼贴讲解视频”时使用；也承接 ray-kb / ray-writer / ray-cover 产出后的视频化下游需求。不用于：需要精确图层与时间线控制（转 HyperFrames）、只要提示词不要成片、真人口播或产品实拍广告。

Docs & Writing47 installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs