CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-llm-wiki

Build and maintain an LLM-powered second brain in Obsidian using Andrej Karpathy's LLM Wiki pattern. Run Claude Code inside the vault to process raw sources into a structured, cross-referenced wiki. Use when setting up an AI-maintained knowledge base, ingesting articles/transcripts/notes, writing daily journals, clearing an inbox, finding orphan notes (brain-dump), querying the wiki, or running a health check (lint). Tracks projects, meetings, content, revenue, and fitness.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable — verbatim templates, exact schemas, and per-operation step lists leave nothing abstract — and mostly token-efficient. Its weaknesses are the absence of post-write validation in the batch operations (ingest, inbox), which caps workflow clarity, and a monolithic structure that inlines the CLAUDE.md and note templates instead of shipping them as bundle files.

Suggestions

Move the verbatim CLAUDE.md template and the five note templates into bundle files (e.g., assets/claude-md.md, assets/templates/) and reference them by path, keeping SKILL.md as a lean overview.

Add a post-write validation step to the batch operations: after ingest or inbox runs, verify new wikilinks resolve and the index is in sync (or invoke the lint checks) before reporting success.

Trim the 'Core Insight' section's RAG-vs-compilation explanation and tagline flourishes ('Knowledge compounds.') — Claude can infer the motivation from a one-line statement.

DimensionReasoningScore

Conciseness

The bulk of the body is non-derivable specification that earns its tokens — the vault directory tree, the verbatim CLAUDE.md, the frontmatter schema, per-operation numbered workflows — with only minor trimmable material such as "Traditional RAG re-searches raw documents on every query" (a concept Claude already knows), "Knowledge compounds.", and "Surfaces problems you didn't know existed.". This fits anchor 4 (efficient with minor over-explanation); it is not 3 because almost no section explains known concepts at length, and not 5 because the Core Insight section and occasional flourishes could still be cut.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: a copy-paste-ready CLAUDE.md ("Write `CLAUDE.md` in the vault root (verbatim)"), five complete note templates with frontmatter, exact paths ("`wiki/sources/{slug}.md`", "`output/brain-dump-YYYY-MM-DD.md`"), concrete report formats for lint and brain-dump, and a runnable one-shot command ("`claude --add-dir ~/Documents/Vault \"/obsidian-llm-wiki ingest https://example.com/article\"""). This matches anchor 5's copy-paste-ready coverage of the common cases.

5 / 5

Workflow Clarity

Every operation has a clear numbered sequence and some checkpoints exist ("Announce the plan: list pages you'll create or update", brain-dump's "Ask: 'Fix automatically, or review first?'", and end-of-run reports), but the batch operations lack post-write validation: ingest ("Typically touches 5–15 pages per source") and inbox (routing all items then archiving them to `raw/`) have no verify step or feedback loop — no link check, no lint invocation after writes. Per the guideline capping batch operations without validation at 3, this lands at anchor 3 rather than 4; it is above anchor 2 because sequences are explicit and several checkpoints are present.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything lives in one ~440-line SKILL.md. Sections are well organized and navigable, but large blocks that clearly belong in separate files are inlined — the ~80-line verbatim CLAUDE.md and ~100 lines of note templates — which a maintainer must copy out by hand. This matches anchor 3 (good structure, but content that should be separate is inline); it is not 2 because the file is cleanly sectioned and easy to navigate, and not 4 because there are no references at all and the inlined template blocks are substantial.

3 / 5

Total

15

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities across the skill's full lifecycle, includes an explicit 'Use when...' clause with specific triggers, and is clearly scoped to a distinct niche. The only weakness is minor missing natural synonyms (e.g., 'daily notes' instead of only 'daily journals').

DimensionReasoningScore

Specificity

The description lists multiple concrete actions spanning the full lifecycle — "Build and maintain an LLM-powered second brain", "Run Claude Code inside the vault to process raw sources into a structured, cross-referenced wiki", plus "ingesting articles/transcripts/notes, writing daily journals, clearing an inbox, finding orphan notes (brain-dump), querying the wiki, or running a health check (lint)". Coverage runs from setup through maintenance to query and health check with no significant gaps, matching the comprehensive-coverage anchor; it exceeds anchor 4 because nothing major is missing rather than having 'minor gaps'.

5 / 5

Completeness

It explicitly answers both questions: what ("Build and maintain an LLM-powered second brain in Obsidian... process raw sources into a structured, cross-referenced wiki... Tracks projects, meetings, content, revenue, and fitness") and when (an explicit "Use when setting up an AI-maintained knowledge base, ingesting articles/transcripts/notes, writing daily journals, clearing an inbox, finding orphan notes (brain-dump), querying the wiki, or running a health check (lint)" clause with concrete trigger phrases). This matches anchor 5; it is above anchor 4 because the 'when' is not merely present but enumerates specific triggers.

5 / 5

Trigger Term Quality

Natural trigger terms are well covered: "second brain", "knowledge base", "Obsidian", "vault", "ingesting articles/transcripts/notes", "daily journals", "inbox", "orphan notes", "querying the wiki", "health check (lint)". A few natural phrases users would say are missing — notably "daily notes" (Obsidian's native term, vs. "daily journals"), and common PKM phrasings like "personal knowledge management" or "meeting notes" — so it fits anchor 4 rather than the comprehensive-synonyms anchor 5, while clearly exceeding anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The description claims a clear niche — "an LLM-powered second brain in Obsidian using Andrej Karpathy's LLM Wiki pattern" with "Run Claude Code inside the vault" — and its triggers (vault wiki ingestion, brain-dump, wiki lint) are unlikely to fire for unrelated skills. It fits anchor 5's 'clear niche with distinct triggers; minimal conflict risk'; anchor 4's 'minor overlap risk' would apply only if a closely related Obsidian-notes skill existed, and the explicit scoping to Obsidian and the LLM Wiki pattern keeps conflict risk minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

valeriibeck-star/claude-skills

Path

skills/obsidian-llm-wiki/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.