CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-vault-architect

Designs and enforces folder structure, naming conventions, and template standards for Obsidian vaults.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/obsidian-vault-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 compact, well-structured instruction-only skill with good safety practices and failure-mode coverage, but the guidance stops at the directive level — no example naming conventions, template formats, or post-rename validation. Adding concrete artifact examples and a link-integrity verification step would close the main gaps.

Suggestions

Add a post-rename validation step (e.g., verify no broken wikilinks/attachments after the rename batch, fix and re-run until clean) to satisfy the batch-operation feedback-loop requirement.

Include at least one concrete example per key artifact: a sample naming convention pattern, a minimal template file, and a starter MOC/tag-taxonomy entry.

Document how renames should be performed so Obsidian's link graph stays intact (in-app rename vs. filesystem rename plus link rewrite), since a bare filesystem rename batch silently breaks links.

DimensionReasoningScore

Conciseness

The body is lean and well-sectioned with no padding or explanations of concepts Claude already knows (PARA and Zettelkasten are named without tutorials), but minor trimmable content remains — the Invocation section and Companion Skills list add little executable guidance — so it fits anchor 4 rather than the every-token-earns-its-place profile of anchor 5.

4 / 5

Actionability

The workflow directives are concrete in outline (PARA top-level folders are enumerated: Inbox, Projects, Areas, Resources, Archive) but key execution details are missing — no example naming convention, template file format, MOC structure, or tag taxonomy format — matching anchor 3 (some concrete guidance but incomplete) rather than the mostly-executable profile of anchor 4.

3 / 5

Workflow Clarity

The six steps (Audit, Design, Templates, Tag taxonomy, MOC, Enforce) form a clear sequence with pre-flight checkpoints (backup required, user confirmation before renames), but this is a batch/rename operation with no post-change validation or feedback loop — e.g., verifying wikilinks are not broken after renames — and the rubric explicitly caps batch operations lacking validation at 3.

3 / 5

Progressive Disclosure

The body is roughly 55 lines of well-organized sections (Purpose, Workflow, Inputs, Outputs, Safety, Failure Modes, References) with no bundle files and no need for external references; under the rubric's simple-skill allowance this earns anchor 5 despite the empty references/ and scripts/ directories.

5 / 5

Total

15

/

20

Passed

Description

66%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 crisp, third-person description with a clear niche and several concrete actions, but it lacks any 'when to use' trigger clause and omits several natural trigger phrases users would say. Adding an explicit usage trigger would address its main weakness.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to organize or restructure an Obsidian vault, set up folder hierarchies, or standardize note naming and templates."

Include common user phrasings and synonyms such as "organize vault", "restructure notes", or "PARA" to broaden natural trigger coverage.

Optionally mention the tag taxonomy / MOC responsibilities in the description so the stated scope matches the body's actual coverage.

DimensionReasoningScore

Specificity

"Designs and enforces folder structure, naming conventions, and template standards for Obsidian vaults" lists several specific actions (design/enforce folder structure, naming conventions, template standards) with only minor gaps, matching the anchor for several specific actions; it falls short of 5 because broader capabilities the body covers (MOC placement, tag taxonomy) are absent from the description itself.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3; it cannot score 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural keywords like "Obsidian vaults", "folder structure", "naming conventions", and "templates" give good keyword coverage, but common user phrasings and synonyms ("organize my vault", "restructure notes", "PARA") are missing, placing it at anchor 4 rather than 5 and clearly above anchor 3 since the terms present are ones users would actually say.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (Obsidian vault architecture) that is mostly distinct from generic file/document skills, but there is minor overlap risk with closely related vault-writing companion skills (music journal, homelab logbook), fitting anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

pvnkmnk/AgenticSelfHostSkills

Path

skills/obsidian-vault-architect/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.