Obsidian Project Knowledge Base
Galaxy-Dawn/claude-scholar
Maintains a project-scoped Obsidian research knowledge base: bootstrapping its folders, routing notes, updating hub, plan and index notes, and linting.
Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.
SKILL.md written in Chinese; this summary is our English description.
Install Ray Obsidian Vault Setup
$ npx skills add imraywang/rayskills --skill ray-obsidian -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install imraywang/rayskills ray-obsidian --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ray-obsidian .claude/skills/ray-obsidian && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .claude/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidianType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add imraywang/rayskills --skill ray-obsidian -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install imraywang/rayskills ray-obsidian --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/ray-obsidian .agents/skills/ray-obsidian && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .agents/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add imraywang/rayskills --skill ray-obsidian -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install imraywang/rayskills ray-obsidian --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/ray-obsidian .cursor/skills/ray-obsidian && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .cursor/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/imraywang/rayskills.git --path skills/ray-obsidian--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add imraywang/rayskills --skill ray-obsidian -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install imraywang/rayskills ray-obsidian --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/ray-obsidian .gemini/skills/ray-obsidian && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .gemini/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install imraywang/rayskills ray-obsidianInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add imraywang/rayskills --skill ray-obsidian -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/ray-obsidian .github/skills/ray-obsidian && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .github/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add imraywang/rayskills --skill ray-obsidian -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install imraywang/rayskills ray-obsidian --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/ray-obsidian .opencode/skills/ray-obsidian && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ray-obsidian" agent skill from https://github.com/imraywang/rayskills/tree/main/skills/ray-obsidian into .opencode/skills/ray-obsidian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ray-obsidian", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
ray-obsidian- GitHub stars
- 159
- Token cost
- ~625 tokens
- SKILL.md length
- 129 words
- Files
- 37 (incl. scripts, references, assets)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.
- Works in 5 steps: 确定知识库根目录 → 先检查，后初始化 → 安全初始化 → …
- Creating a new Obsidian vault for long-term knowledge and writing
- SKILL.md covers 固定原则, 1. 确定知识库根目录, 2. 先检查，后初始化 and 3. 安全初始化, plus 3 more sections
- Calls python3
What it does
The skill first pins down the vault root from a path you give, a .ray-obsidian.json manifest or a recognizable folder layout, and asks one question if it is still unsure; it never guesses from a folder name. It then runs vault_setup.py check, previews with a dry run, and only creates missing folders and template files, preserving every existing file and leaving the .obsidian folder untouched.
The template separates source material, long-term knowledge, creative work and publishing, with an inbox for ideas and folders for candidate topics, writing tasks, article drafts and spoken-script drafts, plus a feedback review step. After initializing, it re-checks that the vault is ready and hands the vault path to the ray-writer skill. No plugins, sync service or Git are required, and the skill text is in Chinese.
When your agent uses it
- Creating a new Obsidian vault for long-term knowledge and writing
- Checking whether an existing vault has the structure the Ray writing skills expect
- Adding missing folders and templates to a vault without touching its notes
Example prompts
- “Set up an Obsidian vault in ~/notes for my writing workflow.”
- “Check whether my current vault is compatible with ray-writer.”
- “Run the vault init as a dry run first and show me what would be added.”
Requirements
- python3 to run vault_setup.py
Workflow steps
5 steps, taken from the step headings in SKILL.md.
- 确定知识库根目录
- 先检查，后初始化
- 安全初始化
- 复核真实结果
- 交接内容生产
What it can do on your machine
Read from SKILL.md and the folder at commit 2ad2449. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Ray Obsidian Vault Setup loads about 625 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 129 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 129 words (~625 tokens).
- name
- ray-obsidian
Files
SKILL.md and 36 other files (scripts, references, assets) in skills/ray-obsidian of imraywang/rayskills.
- SKILL.md
- agents/openai.yaml
- assets/vault-template/00-入口/10-工作台/创作工作台.md
- assets/vault-template/00-入口/10-工作台/知识工作台.md
- assets/vault-template/10-创作/10-灵感/inbox.md
- assets/vault-template/20-知识/README.md
- assets/vault-template/30-资料/00-待抓取/链接收件箱.md
- assets/vault-template/50-系统/10-文档/知识库设计说明.md
- assets/vault-template/50-系统/20-流程
- … and 28 more
Open the folder on GitHubat commit 2ad2449
Compare with similar skills
Ray Obsidian Vault Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Ray Obsidian Vault Setup this skillimraywang/rayskills | 159 | — | ~625 | Automated safety check: Pass | Custom licence | |
| Obsidian Project Knowledge BaseGalaxy-Dawn/claude-scholar | 5.7k | — | ~551 | Automated safety check: Pass | MIT | |
| Save to Obsidian VaultAgriciDaniel/claude-obsidian | 15k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Vault Methodology RouterAgriciDaniel/claude-obsidian | 15k | — | ~1k | Automated safety check: Pass | MIT | |
| Obsidian Knowledge BuilderMichael-OvO/obsidian-knowledge-agent | 205 | — | ~917 | Automated safety check: Pass | MIT | |
| Luhmann Note Numberertwhsi/skills | 259 | — | ~1.5k | Automated safety check: Pass | None |
Similar skills
Save to Obsidian Vault
AgriciDaniel/claude-obsidian
Files a specific answer, decision or insight you point to in a conversation as one reviewed note in your Obsidian vault, and only when you ask for it.
Vault Methodology Router
AgriciDaniel/claude-obsidian
Reads or changes an Obsidian vault's filing methodology, Generic, LYT, PARA or Zettelkasten, and suggests where planned notes should go without saving or moving anything.
Obsidian Knowledge Builder
Michael-OvO/obsidian-knowledge-agent
Turns PDFs, slides, syllabi, papers and transcripts into structured, teaching-quality Obsidian notes, matching how much structure is built to how much the material needs.
Luhmann Note Numberer
twhsi/skills
Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.
Obsidian Canvas Boards
AgriciDaniel/claude-obsidian
Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.
More from imraywang/rayskills
All 12 skills in this repoRay Trend Search
imraywang/rayskills
Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.
Collage B-Roll Video Maker
imraywang/rayskills
Turns a spoken line or a full topic into editorial-collage videos of halftone cut-outs assembled piece by piece, as 5-second B-roll or a narrated explainer.
Ray Cover
imraywang/rayskills
把已经确定核心判断的文章、成稿包或长文转成公众号、普通 X 分享图与 X Articles 后台封面。提炼一个可一眼读懂的视觉隐喻，按各平台目标尺寸分别使用 Image 2 一次生成画面和准确中文标题；不生成无字底图，不单独排版文字。主要验收隐喻、标题内容、构图、安全区和缩略图可读性。用于“给这篇文章做封面”“公众号和 X 都要封面”“做 5:2 Article 封面”“用 Adrian 或…
Ray Editorial Cover Art Generator
imraywang/rayskills
Generates text-free article cover images in one fixed engraving style, with a quiet central gap and matching left-right scenes, for a publication, X post and X Article size.
Ray Kb
imraywang/rayskills
把灵感、现场观察或长文变成 Ray 能直接开机录制的中文口播：原生快速口播只保留一份母稿；长文再分发则绑定母稿路径与内容指纹。表达先行——以 Ray 本人口吻把观点和情绪说满，拿不准或编补的内容列进「待确认」由 Ray 决定。也按“停下、听下去、记住、传播”四关审读口播，或对照生成稿与 Ray…
Ray Multi-Model Collaboration
imraywang/rayskills
Splits work across Grok, Claude and Codex with the current session as controller, in fast, review, race and scout modes, and checks results itself instead of trusting a model's report.
Related
Works with
Categories
Questions about Ray Obsidian Vault Setup
What does Ray Obsidian Vault Setup do?
Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes. json manifest or a recognizable folder layout, and asks one question if it is still unsure; it never guesses from a folder name.obsidian folder untouched.
When should I use Ray Obsidian Vault Setup?
Ray Obsidian Vault Setup fits situations like: creating a new Obsidian vault for long-term knowledge and writing; checking whether an existing vault has the structure the Ray writing skills expect; adding missing folders and templates to a vault without touching its notes.
How do I install Ray Obsidian Vault Setup in Claude Code?
Run `npx skills add imraywang/rayskills --skill ray-obsidian -a claude-code`. Or copy the skill folder (skills/ray-obsidian in imraywang/rayskills) into .claude/skills/ray-obsidian in your project. Claude Code loads it when a task matches its description.
How do I install Ray Obsidian Vault Setup in Codex?
Run `npx skills add imraywang/rayskills --skill ray-obsidian -a codex`. Or copy the skill folder (skills/ray-obsidian in imraywang/rayskills) into .agents/skills/ray-obsidian in your project. Codex loads it when a task matches its description.
Can I use Ray Obsidian Vault Setup in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add imraywang/rayskills --skill ray-obsidian -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ray-obsidian, .gemini/skills/ray-obsidian, .github/skills/ray-obsidian and .opencode/skills/ray-obsidian in your project.
What does Ray Obsidian Vault Setup need to run?
Going by SKILL.md and its folder, Ray Obsidian Vault Setup needs the command-line tools its instructions call (python3). Our summary lists: python3 to run vault_setup.py.
Does Ray Obsidian Vault Setup access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Ray Obsidian Vault Setup safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Ray Obsidian Vault Setup use?
Ray Obsidian Vault Setup has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Ray Obsidian Vault Setup use?
About 625 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.
What are the alternatives to Ray Obsidian Vault Setup?
Skills that share tags, products or a category with Ray Obsidian Vault Setup: Obsidian Project Knowledge Base (Galaxy-Dawn/claude-scholar, 5.7k stars), Save to Obsidian Vault (AgriciDaniel/claude-obsidian, 15k stars), Vault Methodology Router (AgriciDaniel/claude-obsidian, 15k stars) and Obsidian Knowledge Builder (Michael-OvO/obsidian-knowledge-agent, 205 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Ray Obsidian Vault Setup?
imraywang (a GitHub user) maintains it in imraywang/rayskills, which has 159 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 23, 2026.
Source: imraywang/rayskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.