obsidian-layout-adjustment

Adjust Obsidian vault appearance by editing CSS snippets with screenshot verification.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill obsidian-layout-adjustment-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-layout-adjustment
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/obsidian-layout-adjustment
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill obsidian-layout-adjustment-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Restyling Obsidian with CSS snippets often fails because natural-language requests like "tabs above the note" map to multiple UI layers, leading to edits on the wrong selectors, invisible changes, and frustrating trial-and-error loops. ## Core Features & Use Cases - Phrase-to-Layer Translation: Maps user descriptions of visible Obsidian objects (tab headers, side docks, backlinks, note surface) to stable selector families before editing. - Checkpointed Editing Loop: Reads appearance.json for active snippets, saves named checkpoints outside .obsidian/snippets, patches one owning layer, formats CSS, and screenshot-verifies every visual pass. - Failure Diagnosis: Interprets feedback like "nothing changed" or "still wrapped" as evidence of wrong selector ownership, clipping, or double-styled wrappers, with restore-from-checkpoint recovery. - Use Case: A user says the right sidebar icons are unreadable and backlink cards look overwrapped; the skill maps these to side-dock tab headers and backlink group wrappers, checkpoints the active snippet, makes one scoped fix, and verifies with a cropped screenshot. ## Quick Start Ask the agent to restyle a specific part of your Obsidian vault, for example: make the workspace tab headers higher contrast in my vault and verify it with a screenshot.

Frequently Asked Questions about obsidian-layout-adjustment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change Obsidian appearance with CSS snippets?

Edit the active CSS snippets listed in your vault's .obsidian/appearance.json file, then reload Obsidian and screenshot the affected area to verify. This skill maps your description of a visible element to the correct selector family before patching.

Why did my Obsidian CSS snippet change nothing?

A snippet that changes nothing usually means the wrong selector or layer was targeted, the effect is clipped or covered, or an override wins the cascade. The fix is to remap the visible object to its owning layer rather than adding more CSS to the same target.

What is the difference between Obsidian tab headers and view headers?

Workspace tab headers are the open-note tabs at the top of a pane, while the view header is the row inside a note pane containing arrows, book, and dots icons. Confusing them is a common cause of styling the wrong element.

Can I refactor Obsidian CSS snippets without changing the look?

Yes, by saving a baseline checkpoint, preserving selector order, adding section headers, formatting the CSS, and screenshot-verifying the result. Refactoring should only happen after the visual design is accepted, never during taste exploration.

Where should Obsidian snippet backups be stored?

Store checkpoints and archived experiments in .obsidian/snippet-archive/, never inside .obsidian/snippets. Files in the snippets folder appear in Obsidian's snippet picker, so keeping archives there clutters the active snippet list.