← Back to Skills Marketplace
31
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-core-notes
Description
Maintain Obsidian vault core-file sidecar notes and relationship indexes. Use when working in an Obsidian vault or document/code workspace and creating, edit...
README (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.mdnote and nearest资料索引.mdin 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.mdbefore changing core-file classification. - Read
references/obsidian-linking.mdbefore 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.
Usage Guidance
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-core-notes - After installation, invoke the skill by name or use
/obsidian-core-notes - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 31 downloads so far.
How do I install Obsidian Core Notes?
Run "/install obsidian-core-notes" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Core Notes free?
Yes, Obsidian Core Notes is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Core Notes support?
Obsidian Core Notes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Core Notes?
It is built and maintained by CUPVC (@debtvc2022); the current version is v1.0.0.
More Skills