← 返回 Skills 市场

Obsidian Core Notes

Name: Obsidian Core Notes
Author: debtvc2022

作者 CUPVC · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install obsidian-core-notes

功能描述

Maintain Obsidian vault core-file sidecar notes and relationship indexes. Use when working in an Obsidian vault or document/code workspace and creating, edit...

使用说明 (SKILL.md)

Obsidian Core Notes

Keep source files, generated .core.md notes, and Obsidian relationship indexes synchronized.

Workflow

Confirm the vault/workspace root. Use the current working directory unless the user names another root.

Before writing, run a scan when scope is broad:

python \x3Cskill-dir>/scripts/obsidian_core_notes.py scan --root \x3Cvault-root> --json

For create/edit/move/rename/delete operations, update the matching .core.md note and nearest 资料索引.md in the same turn.

For bulk refreshes, run:

python \x3Cskill-dir>/scripts/obsidian_core_notes.py refresh --root \x3Cvault-root>

Validate after any bulk operation:

python \x3Cskill-dir>/scripts/obsidian_core_notes.py validate --root \x3Cvault-root>

Clean generated notes only when explicitly requested:

python \x3Cskill-dir>/scripts/obsidian_core_notes.py clean-generated --root \x3Cvault-root>

Rules

Treat non-Markdown source files as attachments and generate distinct sidecar notes named \x3Csource filename>.core.md.
Reference existing Markdown core files directly; do not duplicate them.
Put folder navigation in 资料索引.md; put the workspace entrypoint in 核心文件索引.md.
Use only generated markers for safe overwrite or deletion:
- \x3C!-- CORE_FILE_NOTE_V1 -->
- \x3C!-- CORE_FOLDER_INDEX_V1 -->
- \x3C!-- CORE_WORKSPACE_INDEX_V1 -->
Never delete hand-written Markdown notes unless the user explicitly asks.
Exclude dependencies, caches, logs, build output, model artifacts, static vendor bundles, and temporary Office lock files.

References

Read references/core-file-rules.md before changing core-file classification.
Read references/obsidian-linking.md before changing note names, tags, markers, or relationship link conventions.

Scripts

scripts/obsidian_core_notes.py scan: count core candidates and summarize scope.
scripts/obsidian_core_notes.py refresh: create or update .core.md, 资料索引.md, and 核心文件索引.md.
scripts/obsidian_core_notes.py validate: verify generated marker counts and common corruption patterns.
scripts/obsidian_core_notes.py clean-generated: remove only files with generated markers.

安全使用建议

Install only if you want an agent to index and summarize files in an Obsidian vault or workspace. Choose the root carefully because generated notes may copy filenames, metadata, keywords, and short content previews into Markdown files within that workspace.

能力评估

✓ Purpose & Capability

The artifacts coherently support the stated purpose: scanning a user-selected vault or workspace, generating `.core.md` sidecar notes, and maintaining Obsidian folder/workspace indexes.

ℹ Instruction Scope

The skill can broadly read files under the chosen root and write generated Markdown summaries/previews, but this is disclosed and tied to the Obsidian indexing workflow; it tells the agent to confirm scope and scan before broad writes.

✓ Install Mechanism

No privileged installer, package install step, API key setup, or background service is declared; the package consists of markdown instructions, references, a small agent YAML file, and a Python script.

✓ Credentials

Filesystem reads and writes are proportionate to the purpose. The script excludes common dependency/cache/build directories and has no network calls, subprocess execution, shell execution, or credential-store access.

ℹ Persistence & Privilege

The script persists generated notes and indexes inside the selected workspace and can delete generated Markdown files only through an explicit `clean-generated` command that checks for known generated markers.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install obsidian-core-notes
安装完成后，直接呼叫该 Skill 的名称或使用 /obsidian-core-notes 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

obsidian-core-notes 1.0.0 - Initial release. - Synchronizes source files, `.core.md` notes, and relationship indexes in Obsidian workspaces. - Supports scan, refresh, validate, and clean-generated operations via CLI scripts. - Maintains folder and workspace indexes (`资料索引.md`, `核心文件索引.md`). - Ensures safe handling of generated files with specific markers; avoids overwriting or deleting hand-written notes.

元数据

Slug obsidian-core-notes

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题