CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-layout-adjustment

Workflow for working with the user on changing how Obsidian looks using CSS snippets. Use this whenever the user asks to restyle Obsidian, tune a vault's visual layout, adjust tabs, sidebars, note surfaces, properties, backlinks, graph panes, file explorer rows, icons, links, shadows, active states, or CSS snippets. Also use it when the user says a visual CSS change did nothing, still looks wrapped, is not lifted, is unreadable, or needs to be refactored without changing the current appearance.

73

Quality

90%

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 well-structured, disciplined workflow body: the operating loop is clearly sequenced with screenshot validation, checkpointing, and explicit failure-recovery rules, and the reference file is properly one level deep with clear read conditions. The main weaknesses are duplicated translation/mapping content between the body and the reference, and a central patch step that stays abstract where concrete commands would be more executable.

Suggestions

Collapse the 'Translate Before Editing' bullet list and the 'Stable Layer Stack' table into a single mapping (or point to references/workflow-reference.md) — the same phrase-to-object mappings appear in the body twice and again in the reference.

Make the patch/reload steps concrete: name the actual edit mechanism and the Obsidian reload or window-focus command alongside the existing `screencapture -R<x,y,w,h>` example.

Move the detailed per-object mapping rows (e.g., graph, backlinks, status bar) fully into references/workflow-reference.md and keep only the highest-frequency mappings in SKILL.md to sharpen the overview/reference split.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — no tutorials on CSS or Obsidian — but it can be tightened: the "Translate Before Editing" phrase bullets ("tabs above the note", "arrows/book/dots above the note", etc.) substantially duplicate the Stable Layer Stack table a few lines below, and both overlap the reference's larger mapping table. It is not level 5 because redundant mapping content costs tokens; not level 3 because there is no concept-explaining padding.

4 / 5

Actionability

Mostly executable guidance with real paths and commands: "Read `<vault>/.obsidian/appearance.json`", "`enabledCssSnippets` as the active styling source of truth", checkpoints to "`.obsidian/snippet-archive/`", and "`screencapture -R<x,y,w,h> out.png". It stops short of level 5 because the central patch step ("edit one owning layer") and the reload mechanism are described abstractly rather than as concrete commands, and the mapping pipeline block is schematic rather than copy-paste ready.

4 / 5

Workflow Clarity

The 13-step Operating Loop is a clear sequence with explicit validation (the Screenshot Gate: "CSS validity is not visual success") and genuine feedback loops for error recovery ("If it fails, inspect ownership or restore", "If a direction fails twice, restore the last good checkpoint and change the ownership model", the Failure Signals diagnostic list, and the refactor-only-after-acceptance rule). This matches the level-5 anchor: checkpoints, validation, and recovery are all explicit.

5 / 5

Progressive Disclosure

The reference is real, one level deep, and well-signaled with explicit read conditions ("Read `references/workflow-reference.md` when: …"), but the body inlines a layer-stack mapping table that substantially duplicates the reference's translation table, so the split between overview and detail is not clean. Level 4 rather than 5: good structure with a minor organization gap; not level 3 because the reference is clearly signaled and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: it states a concrete capability set, gives explicit and comprehensive "use when" triggers in natural user language (including failure complaints), and is tightly scoped to Obsidian CSS work. Third-person voice and concise trigger enumeration mean no rubric penalties apply.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "restyle Obsidian", "tune a vault's visual layout", "adjust tabs, sidebars, note surfaces, properties, backlinks, graph panes, file explorer rows, icons, links, shadows, active states", and "refactored without changing the current appearance" — with comprehensive coverage of the Obsidian UI surface. It goes beyond the level-4 anchor because both the action verbs and the target objects are fully enumerated rather than leaving minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is stated concretely ("Workflow for working with the user on changing how Obsidian looks using CSS snippets") and the "when" is explicit with two trigger clauses ("Use this whenever the user asks to restyle… Also use it when the user says a visual CSS change did nothing…"). This matches the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered: UI nouns users would actually say ("tabs", "sidebars", "file explorer rows", "backlinks", "CSS snippets") plus complaint phrases in the user's own voice ("did nothing", "still looks wrapped", "is not lifted", "is unreadable"). No natural terms are missing; third-person voice is used correctly with no first/second person to penalize.

5 / 5

Distinctiveness Conflict Risk

"Obsidian" is named repeatedly and the skill occupies a clear niche (vault CSS snippet restyling with failure diagnosis), so it is easily distinguished from generic CSS or app-styling skills with minimal conflict risk.

5 / 5

Total

20

/

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
Ar9av/obsidian-wiki
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.