CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-vault-setup

Use when setting up the shared atmosphere-vault Obsidian vault on a new machine or for a new team member. Guides through cloning, installing plugins, symlinking claude_docs, and verifying the Obsidian CLI.

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary operational runbook: lean, fully executable, and defensively validated, with explicit constraints and success criteria. The only structural observation is that it is a single ~130-line file with no progressive-disclosure layer, which is a minor organization gap rather than a defect.

DimensionReasoningScore

Conciseness

The body is almost entirely executable commands, defaults, and constraints with no conceptual padding — it never explains what Obsidian or git cloning is. Prose is limited to operationally necessary notes (e.g., the npm 'obsidian-cli' shadowing warning, the single-commit-timer caveat), so every token earns its place.

5 / 5

Actionability

Every step is copy-paste ready: concrete bash blocks with defined variables ($PROJECT_DIR, $VAULT_DIR), a defaults section, idempotent script invocation, and a GUI checklist for Step 5. It also covers the common error paths (missing Obsidian app, npm CLI shadowing, pre-existing claude_docs directory).

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation at nearly every stage: prerequisite checks (Step 1), main-branch verification (Step 2), a destructive-operation safety check that aborts before symlinking (Step 4), an end-to-end sync verification with cleanup (Step 6), plus a Success Criteria checklist. Error-recovery guidance is present (npm uninstall, back-up-and-abort), matching the top anchor.

5 / 5

Progressive Disclosure

Well-organized single-file structure (Role, When to Use, Defaults, Workflow, Constraints, Success Criteria) with all content being core workflow. However, at ~130 lines it exceeds the under-50-line case where sections alone suffice, and there are no reference files — detail like the plugin settings inventory in Step 3 could live in a reference, so this sits just below the top anchor.

4 / 5

Total

19

/

20

Passed

Description

87%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: third-person voice, explicit 'Use when' trigger, and a concrete action list tied to a named vault. Its only weakness is that the action list omits a couple of workflow steps (opening the vault in Obsidian, verifying sync), which slightly limits specificity and keyword coverage.

DimensionReasoningScore

Specificity

The description lists four concrete actions — 'Guides through cloning, installing plugins, symlinking claude_docs, and verifying the Obsidian CLI' — which is specific and actionable. It stops just short of anchor 5 because the workflow also includes opening the vault in Obsidian and verifying the sync flow, so coverage is not fully comprehensive.

4 / 5

Completeness

It explicitly answers both questions: what ('Guides through cloning, installing plugins, symlinking claude_docs, and verifying the Obsidian CLI') and when ('Use when setting up the shared atmosphere-vault Obsidian vault on a new machine or for a new team member') with concrete trigger phrasing.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'setting up the shared atmosphere-vault Obsidian vault', 'on a new machine', 'for a new team member'. Good coverage, but a few natural variations (e.g., 'onboard', 'sync', 'install Obsidian plugins' as standalone requests) are only implied, keeping it below the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

It names a specific, niche target ('the shared atmosphere-vault Obsidian vault') with a clearly scoped use case (new machine / new team member onboarding), so it is unlikely to fire for unrelated skills.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

Atmosphere/atmosphere

Path

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