obsidian-vault-linker

Discover missing links, orphaned notes, thematic clusters, and connection opportunities across the Obsidian vault. Use when your knowledge base feels fragmented or you suspect hidden connections between notes.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

71%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.

A highly actionable, well-sequenced workflow with executable commands and a proper approval checkpoint before mutating notes. Weaknesses are redundancy across three overlapping trigger sections and bundle scripts that are present but never surfaced from the body.

Suggestions

Consolidate the When to Use, Modes, and Example Invocations sections into one to remove repeated trigger examples and tighten the body.

Reference the bundle scripts (e.g., vault_audit_phase2.py, vault_audit_phase3.py) from the corresponding workflow phases so the provided files are discoverable instead of orphaned.

Drop the quoted article excerpt and 'knowledge gardening' metaphor from the Purpose section; the concrete capabilities already convey the value.

Dimension	Reasoning	Score
Conciseness	Mostly efficient command listings, but padded with a quoted article excerpt, a 'knowledge gardening' metaphor, and redundant trigger examples repeated across the When to Use, Modes, and Example Invocations sections.	3 / 5
Actionability	Provides copy-paste-ready PowerShell and Python commands with real paths across all five phases, plus a concrete report template and an executable append example — fully executable covering the common cases.	5 / 5
Workflow Clarity	Five phases are clearly sequenced and Phase 5 includes an explicit user-approval gate ('Only apply links the user explicitly approves'), satisfying validation for the batch write operation; minor gap is no technical validate→fix→retry loop before applying.	4 / 5
Progressive Disclosure	The body is well-sectioned but four bundle scripts exist in ./scripts/ (vault_audit.py, vault_audit_phase2.py, vault_audit_phase3.py, vault_read_notes.py) that implement the workflow yet are never referenced or linked from the body, leaving navigation to them unclear.	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, third-person description that clearly states both capabilities and trigger conditions with a distinct Obsidian-specific niche. The only weakness is a trigger clause framed around user feelings rather than the concrete action phrases users naturally say.

Dimension	Reasoning	Score
Specificity	Lists four concrete action categories — 'missing links, orphaned notes, thematic clusters, and connection opportunities' — giving comprehensive, specific coverage rather than vague domain mention.	5 / 5
Completeness	Explicitly answers both what ('Discover missing links, orphaned notes, thematic clusters, and connection opportunities') and when ('Use when your knowledge base feels fragmented or you suspect hidden connections').	5 / 5
Trigger Term Quality	Includes natural terms ('missing links', 'orphaned notes', 'Obsidian vault', 'hidden connections') but the trigger clause ('feels fragmented or you suspect hidden connections') is feeling-based and omits common action phrases users actually say like 'link my vault' or 'vault audit'.	4 / 5
Distinctiveness Conflict Risk	Scoped specifically to Obsidian vault graph analysis with distinct triggers, making conflict with other skills minimal.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: 0xRabbidfly/Eric-Cartman
Path: .github/skills/obsidian-vault-linker/SKILL.md
Commit: aa16c9e

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.