Use this skill whenever the user wants to work with Obsidian in any capacity. This is the ONLY skill for Obsidian vaults, .base files, Obsidian Markdown, Obsidian plugins, and Obsidian Web Clipper. Trigger for: creating or editing notes with wikilinks, callouts, embeds, or frontmatter; building or debugging .base files (formulas, filters, views, YAML quoting); Obsidian plugin development or hot-reload; Web Clipper JSON templates or AI Interpreter prompts; vault structure, daily notes, or the obsidian CLI. Also trigger when the user describes Obsidian-specific problems without naming Obsidian — like .base YAML errors, foldable callout syntax, base formula for tasks due this week, or clipper template for arxiv. Do NOT trigger for Logseq, Notion, Dataview plugin queries, generic markdown processing scripts, or general-purpose Chrome extensions.
75
92%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that thoroughly covers capabilities, trigger conditions, and boundary cases. It provides rich natural-language trigger terms, explicitly addresses both positive and negative matching scenarios, and clearly carves out a distinct niche. The only minor note is the use of second-person voice ('Use this skill whenever the user wants'), but this is a common convention in skill descriptions and doesn't significantly harm clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creating/editing notes with wikilinks, callouts, embeds, frontmatter; building/debugging .base files with formulas, filters, views; plugin development; Web Clipper JSON templates; vault structure; daily notes; CLI usage. | 3 / 3 |
Completeness | Clearly answers both 'what' (working with Obsidian vaults, .base files, plugins, Web Clipper, notes) and 'when' with explicit trigger guidance ('Trigger for:', 'Also trigger when', 'Do NOT trigger for'). The 'Use this skill whenever' and detailed trigger clauses make selection criteria unambiguous. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'Obsidian', 'wikilinks', 'callouts', 'embeds', 'frontmatter', '.base files', 'hot-reload', 'Web Clipper', 'daily notes', 'obsidian CLI', 'foldable callout syntax', 'base formula', 'clipper template', and even implicit triggers like '.base YAML errors'. Also includes negative triggers to reduce false matches. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit negative boundaries ('Do NOT trigger for Logseq, Notion, Dataview plugin queries, generic markdown processing scripts, or general-purpose Chrome extensions') and a clear niche focused exclusively on Obsidian. The description even addresses edge cases where users might describe Obsidian problems without naming Obsidian. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, comprehensive Obsidian skill that covers four distinct domains with clear workflows, concrete syntax examples, and excellent progressive disclosure to reference files. Its main weakness is moderate verbosity in the Markdown section where some explanations cover concepts Claude already knows. The Bases and CLI sections are particularly strong with actionable, copy-paste ready examples and clear validation/troubleshooting guidance.
Suggestions
Trim the Obsidian Flavored Markdown section by removing explanations of concepts Claude already knows (e.g., 'Define a block ID by appending...', the note about wikilinks vs markdown links, tag character rules) — keep only the syntax reference tables and the complete example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some content Claude already knows (standard markdown syntax mentions, explaining what tags are, what properties mean). The Markdown section especially could be tighter — e.g., the complete example note is helpful but the surrounding explanations of basic concepts like frontmatter and inline tags add tokens without much value. However, the Bases and CLI sections are quite efficient with their table/code-block format. | 2 / 3 |
Actionability | The skill provides concrete, copy-paste ready syntax examples throughout — wikilink syntax, .base YAML schemas, CLI commands, filter expressions, formula examples with correct/incorrect patterns, and Web Clipper JSON output format. The YAML schema for bases is particularly well-structured with executable examples, and the CLI section provides real command patterns. | 3 / 3 |
Workflow Clarity | Each domain has a clearly sequenced workflow. The Bases workflow includes explicit validation steps (step 5: validate YAML, check property references, common issues listed; step 6: test in Obsidian with error recovery guidance). The Web Clipper workflow has 6 numbered steps with verification rules and explicit fallback instructions ('ask for another URL'). The Markdown workflow includes a verify step. The plugin dev workflow shows a reload→check errors→verify visually sequence. | 3 / 3 |
Progressive Disclosure | Excellent structure with a top-level domain table pointing to reference files, inline essentials kept concise, and clear one-level-deep references throughout (e.g., 'See references/bases-functions.md for complete reference', 'See references/clipper-variables.md'). The skill serves as a navigable overview without burying content in nested references. Official docs links are provided as fallbacks. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
dd10cc1
Table of Contents
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.