← Back to Skills Marketplace
Obsidian Wiki
by
Jérôme Benoit
· GitHub ↗
· v1.2.2
· MIT-0
294
Downloads
0
Stars
0
Active Installs
15
Versions
Install in OpenClaw
/install obsidian-wiki
Description
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...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-wiki - After installation, invoke the skill by name or use
/obsidian-wiki - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 294 downloads so far.
How do I install Obsidian Wiki?
Run "/install obsidian-wiki" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Wiki free?
Yes, Obsidian Wiki is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Wiki support?
Obsidian Wiki is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Wiki?
It is built and maintained by Jérôme Benoit (@jerome-benoit); the current version is v1.2.2.
More Skills