cyrene-obsidian-workspace

cyrene-obsidian-workspace is a skill for Claude Code, Codex from Playa-0v0/Cyrene-Agent. It costs 42 tokens per session (985 once invoked), scanned A, original, MIT.

A set of rules for an agent working with an Obsidian vault, a folder of linked Markdown notes. It defines where materials, notes, exercises, templates, and progress files belong and how they may be edited.

In plain words
What is it for?
Use it to list and search vault files, read complete notes or selected headings, create or update Markdown files, and maintain exercises and learning records.
Why use it?
It reduces the chance of reading outside the vault or overwriting the wrong note. It also provides consistent ways to find files, read sections, create notes, and maintain learning progress.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to list and search vault files, read complete notes or selected headings, create or update Markdown files, and maintain exercises and learning records.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Playa-0v0/Cyrene-Agent --skill cyrene-obsidian-workspace
Clone the repo
git clone --depth 1 https://github.com/Playa-0v0/Cyrene-Agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cyrene-obsidian-workspace

README.md
[![agentmods](https://agentmods.dev/badge/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace/github.svg)](https://agentmods.dev/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace)
Your own site
<a href="https://agentmods.dev/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace"><img src="https://agentmods.dev/badge/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cyrene-obsidian-workspace

Your own site · 80×15
<a href="https://agentmods.dev/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace"><img src="https://agentmods.dev/badge/skills/playa-0v0/cyrene-agent/cyrene-obsidian-workspace.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 985 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00042 $0.00985
Opus 5 $0.00021 $0.00492
Sonnet 5 $0.00008 $0.00197
Haiku 4.5 $0.00004 $0.00098

Measured 6d ago against content hash 41b27e69b775, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

cyrene-obsidian-workspace scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (contracts.ts, index.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/cyrene-obsidian-workspace/SKILL.md · 102 lines

What it actually says

Cyrene Obsidian Workspace

本 Skill 描述 Cyrene 在 Learn 模式下如何操作绑定的 Obsidian Vault。常驻规则已由 learn_system.md 定义,本 Skill 只保留可执行的文件操作规范。

Vault 目录约定

当前会话绑定的 Vault 根目录为 workspaceRoot。所有相对路径均基于该根目录。

目录 用途 默认权限
materials/ 用户放置原始学习资料 只读
notes/ 学习笔记 读写
exercises/ 练习、测验、复盘 读写
exams/ 正式试卷、答案解析、考试复盘 读写
templates/ 通用模板 读取
learn/progress.md 学习进度总览 读写(静默维护)

用户可以在 materials/notes/exercises/ 下自行创建子目录(如 notes/英语/notes/论文精读/)。子目录名称可以使用中文。

读取文件

列出文件

  • 使用 obsidian_list_files 获取 Vault 整体结构。
  • 不确定文件位置时,先用 obsidian_search 搜索关键词。

读取全文

  • 使用 obsidian_read_file 读取 notes/exercises/materials/ 下的文件。
  • 读取前确认路径在 Vault 内,不接受绝对路径。

按标题读取章节

  • 使用 obsidian_read_section# / ## / ### 标题定位。
  • 直属正文:指定标题下、遇到下一个同级或更高级标题之前的内容。
  • 完整章节:指定标题及其所有子标题的完整内容。

例如文件结构:

# 主题

## 概念 A
概念 A 正文。

### 细节 1
细节 1 正文。

## 概念 B
概念 B 正文。
  • obsidian_read_section 指定 ## 概念 AincludeChildren=false → 只返回 "概念 A 正文。"。
  • obsidian_read_section 指定 ## 概念 AincludeChildren=true → 返回 "概念 A 正文。" + "### 细节 1" + "细节 1 正文。"。

写入文件

创建新文件

  • 使用 obsidian_editcreate 操作。
  • 创建前确认父目录存在(工具通常会自动创建)。
  • 如果文件已存在,不得覆盖,改为追加或提示用户。

修改已有文件

  • 必须先 obsidian_read_file 读取文件,获取 contentHash
  • 使用 obsidian_editreplace_sectionreplace_all 操作时,必须传入 expectedContentHash
  • 如果 contentHash 不匹配,说明文件已被修改,必须重新读取后再操作。

追加内容

  • 优先使用 appendappend_to_section
  • 适合在笔记末尾添加新的理解、链接或总结。

安全规则

  • 不操作 .obsidian/ 目录。
  • 不跳出绑定的 Vault 根目录。
  • 不覆盖已有文件。
  • materials/ 默认只读;用户明确要求标注原始资料时例外。
  • 不创建无意义的空占位文件。

常用路径模板

  • 新主题笔记:notes/<subject>/<topic>.md
  • 新练习/复盘:exercises/<subject>/<yyyy-mm-dd>-<topic>.md
  • 正式试卷:exams/<subject>/<yyyy-mm-dd>-<topic>-试卷.md(答案解析、考试复盘同目录同前缀)
  • 进度总览:learn/progress.md
  • 主题模板:templates/topic-template.md
  • 复盘模板:templates/review-template.md
Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago Changed · +2 lines 41b27e69b775
  2. 13d ago First seen · 100 lines · 42 tokens per session scan A 91ea698d2ac1

Subscribe to this mod's changes

cyrene-obsidian-workspace is a skill published in the GitHub repository Playa-0v0/Cyrene-Agent (594 stars, last pushed 2d ago), licensed MIT. It adds 42 tokens to every session and 985 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

project-setup-info-local

Comprehensive setup steps to help the user create complete project structures in a VS Code workspace; this tool is designed for full project initialization and scaffolding, not for creating individual files. When to use this tool: user wants to create a new complete project from scratch; setting up entire project…

microsoft/vscode · 263 tokens

update-skills

Create or update repository skills and instructions when major learnings are discovered during a session. Use when the user says "learn!", when a significant pattern or pitfall is identified, or when reusable domain knowledge should be captured for future sessions.

microsoft/vscode · 51 tokens

github-copilot-upgrader

Use this to update the Github Copilot CLI/SDK.

microsoft/vscode · 18 tokens

commit

Commit staged or unstaged changes with an AI-generated commit message that matches the repository's existing commit style. Use when the user asks to 'commit', 'commit changes', 'create a commit', 'save my work', or 'check in code'.

microsoft/vscode · 52 tokens

sync

Sync the current session branch with its upstream branch, or publish the current session branch to a remote. Use when the user asks to sync a branch, pull latest changes, rebase onto upstream, push current branch, publish branch, or set upstream.

microsoft/vscode · 52 tokens

generate-run-commands

Generate or modify run commands for the current session. Use when the user wants to set up or update run commands that appear in the session's Run button.

microsoft/vscode · 36 tokens