← 返回 Skills 市场
Obsidian Wiki
作者
Jérôme Benoit
· GitHub ↗
· v1.2.2
· MIT-0
294
总下载
0
收藏
0
当前安装
15
版本数
在 OpenClaw 中安装
/install obsidian-wiki
功能描述
Build and maintain a compiled LLM Wiki inside an Obsidian vault following Karpathy's pattern. Use when working with an Obsidian vault as a persistent knowled...
安全使用建议
What this skill will do: locate an Obsidian vault (via a user path or by reading local Obsidian config), read files under raw/, and create/update pages under wiki/ and machine state under .wiki-meta/ (manifest, graph.json, etc.). It may download webpages (web_fetch) or extract PDFs (pdftotext) during ingest and may run markdownlint via npx to auto-fix markdown. Before installing or running it, consider: 1) Review the included scripts (they run locally and will modify files under the vault). 2) Run it first on a test or backed-up vault so you can inspect changes. 3) When the skill infers the vault from your Obsidian config, the SKILL.md says it will ask for confirmation before any writes—ensure you only approve writes to the intended vault. 4) Be aware that optional actions (npx install, web_fetch) pull network resources; if you want to avoid network activity, skip those optional steps or run in offline mode. Overall the package appears internally consistent with its stated purpose; proceed if you trust the author and have a backup of your vault.
功能分析
Type: OpenClaw Skill
Name: obsidian-wiki
Version: 1.2.2
The obsidian-wiki skill bundle is a comprehensive toolset for managing a structured knowledge base within an Obsidian vault, following Karpathy's LLM Wiki pattern. It includes well-documented Bash and Python scripts for tasks such as indexing (wiki-index.sh), linting (wiki-lint.sh, wiki-lint-links.py), and delta tracking (wiki-manifest.sh). While the skill performs broad file operations and executes scripts, its behavior is strictly aligned with its stated purpose, and it includes safety features like requiring user confirmation for inferred vault paths and respecting ownership rules between the agent and the user.
能力评估
Purpose & Capability
Name/description match the provided artifacts: the skill includes multiple scripts to ingest sources, generate index/graph, lint/fix wikilinks, and manage a manifest; these are exactly what's needed to implement an LLM-compiled wiki. Reading Obsidian config to locate the vault and using pdftotext/markdownlint for optional processing are justified by the documented workflows.
Instruction Scope
SKILL.md and the scripts limit actions to vault-local operations (reading raw/, writing/maintaining wiki/, creating .wiki-meta/manifest.json, generating index/log). The runtime instructions explicitly prefer user-specified vault paths and require confirmation before write when the vault is inferred. The only wider-scope actions are optional: using web_fetch to download web pages for ingestion and running pdftotext/markdownlint, which are appropriate for ingest workflows.
Install Mechanism
This is instruction-only (no install spec). All needed code is included in the skill bundle. Optional tooling may be installed at runtime (e.g., markdownlint via npx, pdftotext via poppler). These are expected for the tasks but imply network package pulls when used (npx). No arbitrary external downloads or obscure install URLs are present in the bundle.
Credentials
The skill declares no required environment variables or credentials. Scripts read user-local Obsidian config locations to infer vaults (justified by the purpose). It uses standard filesystem and temp files, and may use agent tools (web_fetch/pdf) to ingest external sources; no secrets or unrelated service tokens are requested.
Persistence & Privilege
always:false and autonomous invocation are default. The skill writes only to the specified vault (creates/updates wiki/ and .wiki-meta within the vault) and proposes changes to _meta files (which the instructions say should be approved by the user). It does not modify other skills or system-wide agent settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install obsidian-wiki - 安装完成后，直接呼叫该 Skill 的名称或使用
/obsidian-wiki触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.2.2
v1.2.2: Fix type double-count in lint, reject symlinks in manifest mark, bridge→articulation point terminology, multi-line %% comment handling in index summary, exclude index/log from markdownlint. Add raw/specifications/ subfolder + specification tag. Align vault. Audit score 8.17/10.
v1.2.1
Semantic coherence fixes: align check lists across SKILL.md and agents-template (all 8 checks), fix Prerequisites python3 scope, correct grep fallback description, complete STATS format, add wiki-crosslink.py to internal dependencies, move crosslink out of Search section
v1.2.0
v1.2.0: Shared wiki_lib.py library (WikiMap), wiki-crosslink.py (unlinked mention detection/fix), wiki-graph.py (graph export + Tarjan articulation points), wiki-search.sh (qmd/grep fallback), 79 corrections over 13 audit rounds (Opus+GPT+Sonnet). Fence regex CommonMark compliant, atomic writes everywhere, iterative Tarjan, hyphen-safe crosslink boundaries, reference-style markdown protection, table-aware pipe escaping in crosslink fix.
v1.1.6
- Removed the file _meta.json from the skill.
- No functional or workflow changes; only metadata cleanup.
v1.1.5
- Added a configuration file for markdownlint CLI2 (markdownlint-cli2.json) to enable reproducible and customizable markdown linting.
- Updated scripts/wiki-lint.sh to support using the new markdownlint-cli2.json configuration for improved markdown structure checks.
v1.1.4
obsidian-wiki v1.1.4
- Added _meta.json for internal metadata management.
- Updated core scripts: wiki-index.sh, wiki-lint-links.py, wiki-lint.sh.
- No changes to user-facing workflows or behavior.
v1.1.3
Fix wiki-index.sh: local variable ordering bug on macOS bash caused build_section to search wiki/ root instead of subdirectories, producing an index showing only index.md and log.md in every section
v1.1.2
obsidian-wiki 1.1.2
- Clarified prerequisites in documentation: scripts now explicitly require `bash` and `python3`, with `pdftotext` and `markdownlint-cli2` marked as optional.
- Improved documentation formatting and structure, especially vault resolution, prerequisites, and script/external tool requirements.
- No core script logic changes; updates focused on user guidance and clarity in SKILL.md and reference templates.
v1.1.1
- Clarified the intended use: this skill is only for working with compiled LLM wikis in Obsidian, not for general note-taking or Q&A.
- Updated the description and instructions in SKILL.md to highlight scope boundaries and when not to use this skill.
- No changes in core workflows, page formats, or script usage.
- Improved documentation for new users, reducing accidental misuse for non-wiki tasks.
v1.1.0
11 audit rounds, 124 corrections: API refactoring (wiki-lint --fix), markdownlint integration, atomic writes, resilience hardening, ambiguity enforcement, error propagation, token efficiency, portability improvements
v0.3.1
Round 11: case-insensitive ambiguity enforcement, processing errors in exit status, atomic same-filesystem writes, regex-safe path exclusions, collision-resistant placeholders, protection order fix
v0.3.0
10 audit rounds, 116 corrections: API refactoring (wiki-lint --fix), markdownlint integration, atomic writes, resilience hardening, token efficiency, error UX improvements
v1.0.2
Address ClawHub review: explicit vault confirmation before writes, approval-gated _meta/ edits in setup/maintain, detailed script prerequisites, scoped extract-book-digests output.
v1.0.1
Fix lint false positives on escaped wikilinks in markdown tables; enrich bare [[filename]] links to [[filename|Title]] in fix-wikilinks.py; document table wikilink escaping in SKILL.md.
v1.0.0
Initial release: LLM Wiki pattern for Obsidian vaults. Includes wiki-manifest.sh, wiki-lint.sh, wiki-index.sh, fix-wikilinks.py, extract-book-digests.sh. Supports ingest, query, lint, maintain workflows with provenance tracking and delta manifests.
元数据
常见问题
Obsidian Wiki 是什么？
Build and maintain a compiled LLM Wiki inside an Obsidian vault following Karpathy's pattern. Use when working with an Obsidian vault as a persistent knowled... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 294 次。
如何安装 Obsidian Wiki？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install obsidian-wiki」即可一键安装，无需额外配置。
Obsidian Wiki 是免费的吗？
是的，Obsidian Wiki 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Obsidian Wiki 支持哪些平台？
Obsidian Wiki 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Obsidian Wiki？
由 Jérôme Benoit（@jerome-benoit）开发并维护，当前版本 v1.2.2。
推荐 Skills