aidenlx/zotlit / .agents/skills/obsidian-css
obsidian-css
VerifiedStyle Obsidian plugin UI Tailwind-first with native components. Use when writing or reviewing any styled React/JSX or CSS in apps/obsidian/ — picking colors, spacing, typography, borders, radius, shadows, dark-mode tokens, the `zt:` prefix, `.zt-root` preflight setup, component wrapper selection, or deciding between a utility, a native element, and a stylesheet.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.3 KB |
| check-references.mjs | script | 2.4 KB |
| modal-layout.md | markdown | 2.7 KB |
| references/components.md | markdown | 9.2 KB |
| references/editor.md | markdown | 14.0 KB |
| references/foundations.md | markdown | 10.1 KB |
| references/plugins.md | markdown | 2.0 KB |
| references/preflights.md | markdown | 3.4 KB |
| references/window.md | markdown | 3.7 KB |
references/preflights.md
View on GitHub# Elements fully styled by Obsidian
Obsidian applies comprehensive styles to bare HTML elements via its global stylesheet. A plain `<button>` or `<input type="text">` already looks like an Obsidian control with no extra classes.
- `<button>`: `inline-flex`, themed bg/color/radius/shadow, height `--input-height`, hover/focus/disabled states. Modifier classes: `mod-cta`, `mod-warning`, `mod-destructive`, `mod-loading`.
- `<input type="text/search/email/password/number">`: themed bg/border/padding/radius, focus ring, placeholder color, height `--input-height`.
- `<input type="date/datetime-local">`: same as text inputs.
- `<textarea>`: same as text inputs, plus `--textarea-radius`, `--textarea-padding`.
- `<select>`: themed bg/border/radius, custom dropdown arrow via background-image, hover/focus states. Modifier class: `.dropdown`.
- `<input type="range">`: custom thumb/track via `-webkit-slider-`*, themed colors. Modifier class: `.slider`.
- `<input type="color">`: custom swatch sizing/radius, themed shadow.
- `<input type="checkbox">`: fully custom appearance, SVG checkmark via mask-image, accent-color theming, `:checked`/`:indeterminate` states.
- `<input type="radio">`: same as checkbox but circular, dot indicator on `:checked`.
- `.checkbox-container` (Toggle): CSS-driven slide toggle with thumb animation, `--toggle-*` variables, small/large sizes. Modifier classes: `is-enabled`, `is-disabled`, `mod-small`.
## Obsidian's unlayered bare-element rules
These are what the `.zt-root` scoped preflight leaves standing: unlayered beats `@layer base`, so each rule below survives inside a plugin root. Neutralize the ones you don't want with a utility, an inline style, or a plain `<div>`.
**Structural:** `<hr>` (`border-top: var(--hr-thickness)` + `margin: 2rem 0` — `.markdown-rendered hr` re-declares only the border, so the 2rem survives there too); `<h1>`–`<h6>` (per-level themed size/weight/color/font/line-height + `var(--p-spacing)` margin-block); `<ol>` (`list-style-type: var(--list-numbered-style)` → numbering survives); nested `ul ul, ol ul` (`list-style-type: disc`) — a **top-level** bare `<ul>` has no rule, so preflight strips its markers; `ul > li, ol > li` (`text-align: start`) and their `::marker` color.
**Inline:** `a` / `a:hover` (accent color, underline, link weight/cursor — this beats preflight's `a { color: inherit }`, so links stay Obsidian-styled); `b`/`strong`; `i`/`em`; `kbd` (mono font, background, padding, radius).
**Global:** `button` (the full Obsidian button box), `iframe`, `audio`, `*` (`box-sizing: border-box`), `:focus { outline: none }` — a focus ring reaches a bare element only through a rule that declares one, e.g. `button:focus-visible`.
Everything else (`<p>`, `<blockquote>`, `<code>`, `<pre>`, `<table>`/`<th>`/`<td>`, `<img>`, `<video>`, `<mark>`, `<sub>`/`<sup>`, `<fieldset>`, a top-level `<ul>`, …) has no bare Obsidian rule — pure Chrome UA, so preflight fully governs it.
## Without `.zt-root`
Outside a scoped root there is no preflight: a width utility sets only width, `border-style` stays `none` (so `zt:border` alone is invisible) and unset sides fall back to UA `medium`, making `zt:border-l-2 zt:border-solid` a full box. Add `zt:border-solid`, set the border inline, or render a `<div>` with the matching ARIA role (`role="blockquote"`, `role="paragraph"`, `role="list"` + child `role="listitem"`, `role="heading"` + `aria-level`, `role="separator"`). Adding `zt-root` is simpler and keeps real semantics.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |