CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-writer

Write well-formatted notes to the atmosphere-vault Obsidian knowledge base. Use this skill whenever creating or updating an ADR, runbook, plan, API doc, guide, session output, or any structured document that should land in the vault — even when the user doesn't say "Obsidian" explicitly. Delegates to obsidian:obsidian-cli to write to the live vault and applies Atmosphere frontmatter and formatting standards.

70

Quality

86%

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

81%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 skill with an excellent five-step workflow: concrete obsidian-cli commands throughout, a verify step, dedup-by-search, and a real error-recovery path for the shadowed-CLI failure mode. Its main weakness is repetition — the frontmatter standards and directory mappings are stated inline in multiple places despite living in the reference file, costing tokens without adding guidance.

Suggestions

Replace the inline "Frontmatter Standards" section with a short pointer to references/vault-structure.md (keeping only the one-line summary per doc type), since the reference file already contains the full field, tag, and naming tables.

Merge the "When to Use" doc-type list with the "Quick Reference" table — both map doc types to target directories, so one table with template and tag columns would eliminate the duplication.

Trim "Key obsidian-cli Patterns" to only the examples not already shown in the Workflow steps (e.g., keep the multi-line create/append example, drop the repeated search and read commands).

DimensionReasoningScore

Conciseness

The body doesn't explain concepts Claude already knows, but it repeats itself: the doc-type-to-directory mapping appears in both "When to Use" and the "Quick Reference" table, and the "Frontmatter Standards" section duplicates the field/tag/naming tables already in references/vault-structure.md almost field-for-field. Mostly efficient but could be meaningfully tightened, which is the 3 anchor; the duplication is more than the "minor instances" of the 4 anchor.

3 / 5

Actionability

Every workflow step is backed by copy-paste-ready commands — obsidian search/read/create/append with realistic worked examples ("ADR-042 Adopt Virtual Threads", query="WebSocket backpressure"), a concrete frontmatter template, and filename conventions. Specific examples cover the common cases, matching the fully-executable 5 anchor.

5 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with an explicit validation checkpoint (Step 5 read-back "to confirm content landed correctly"), search-before-create to avoid duplicates, and a genuine error-recovery loop in Constraints (API-key error → uninstall stray npm package → verify with command -v obsidian). This matches the explicit-validation-with-feedback-loops 5 anchor.

5 / 5

Progressive Disclosure

The body is well structured and defers to a real, clearly signaled, one-level-deep reference (references/vault-structure.md, cited in Step 3 and Constraints, verified to exist). It falls short of 5 because the inline "Frontmatter Standards" section duplicates that reference's content rather than deferring to it — good structure with a minor organization gap, the 4 anchor.

4 / 5

Total

17

/

20

Passed

Description

91%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: explicit what-and-when structure, comprehensive natural trigger terms, and a clearly scoped niche tied to a specific vault and CLI delegation. The only gaps are minor — a generic plan/guide request could pull this skill in, and the concrete write operations are summarized rather than enumerated.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Write well-formatted notes to the atmosphere-vault", "Delegates to obsidian:obsidian-cli to write to the live vault", "applies Atmosphere frontmatter and formatting standards" — with the mechanism specified. It stops short of the 5 anchor because it doesn't enumerate the actual operations (create, append, search, verify), leaving minor gaps in coverage.

4 / 5

Completeness

It clearly answers both questions: the "what" ("Write well-formatted notes to the atmosphere-vault Obsidian knowledge base") and an explicit "when" ("Use this skill whenever creating or updating an ADR, runbook, plan, API doc, guide, session output, or any structured document that should land in the vault") with concrete trigger phrases — a direct match to the 5 anchor, well above the 4 anchor's "when could be more specific".

5 / 5

Trigger Term Quality

Natural trigger coverage is comprehensive for the domain: "ADR, runbook, plan, API doc, guide, session output", plus "vault", "knowledge base", "structured document", and it explicitly catches the case where the user doesn't say "Obsidian". This matches the comprehensive synonyms anchor; nothing material is missing for how users would phrase these requests.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — vault-scoped notes with Atmosphere-specific frontmatter and a delegated CLI — but the trigger list includes generic types like "plan" and "guide" that fire even when the user doesn't mention Obsidian, creating minor overlap risk with general document-creation skills. Mostly distinct, so 4 rather than the minimal-conflict 5.

4 / 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.