CtrlK
BlogDocsLog inGet started
Tessl Logo

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, symlinking claude_docs, and verifying obsidian-cli.

72

Quality

88%

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

88%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 tight, executable runbook: every step is copy-paste-ready, sequencing is clear with real validation checkpoints including a safety guard on the one destructive operation, and the whole thing stays lean. The only structural note is that it is a single ~115-line file with no progressive disclosure, which is appropriate for the task but leaves it just under the top progressive_disclosure anchor.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — bash snippets carry inline comments instead of prose, and nothing explains what Obsidian or symlinks are. Minor redundancy between the 'Role' prose and the 'When to Use' bullets keeps it just short of the every-token-earns-its-place anchor.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands ('git clone git@github.com:Atmosphere/atmosphere-vault.git "$VAULT_DIR"', 'ln -sf "$VAULT_DIR/Claude Outputs" claude_docs') plus exact plugin settings ('Auto-commit interval: 10 minutes') and specific UI steps in Step 5. Even the non-command guidance is concrete.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints: prerequisite checks (Step 1), a guard that aborts before overwriting a real claude_docs/ directory with an actionable error message (Step 4), and an end-to-end sync verification with cleanup (Step 6), reinforced by a Constraints section and Success Criteria. The symlink operation includes the feedback loop expected for destructive operations.

5 / 5

Progressive Disclosure

Well-organized single-file structure (Role, When to Use, Defaults, Workflow, Constraints, Success Criteria) with no bundle files, and all content genuinely belongs inline for a single setup procedure. Anchor 5 requires well-signaled external references, and the under-50-lines exception does not apply to this ~115-line skill.

4 / 5

Total

18

/

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, an explicit 'Use when...' clause with concrete triggering conditions, and specific named actions. Trigger terms are natural and distinctive; only minor synonym coverage and action-scope gaps keep specificity and trigger quality at 4.

DimensionReasoningScore

Specificity

Lists three concrete actions — 'Guides through cloning, symlinking claude_docs, and verifying obsidian-cli' — with only minor gaps in coverage (plugin installation and vault opening are not mentioned). Not 5 because the action list is not comprehensive; not 3 because three specific named actions exceed the 1-2 action bar.

4 / 5

Completeness

Explicitly answers both questions: 'Use when setting up... on a new machine or for a new team member' (when) and 'Guides through cloning, symlinking claude_docs, and verifying obsidian-cli' (what). The 'when' clause is fully explicit with concrete trigger conditions, matching the top anchor rather than the merely-adequate anchor 4.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ('setting up... on a new machine', 'for a new team member', 'Obsidian vault'), but common synonyms like 'onboard' or 'install Obsidian' are missing. Good coverage without the synonym depth of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The named vault ('atmosphere-vault'), specific tooling ('obsidian-cli'), and symlink target ('claude_docs') establish a clear niche with distinct triggers and minimal conflict risk with any related skill.

5 / 5

Total

18

/

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
Atmosphere/atmosphere
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.