# Obsidian Theme Dev

> CSS/SCSS development patterns for Obsidian themes. Load when working with theme.css, SCSS variables, or CSS selectors. Use when this capability is needed.

- Skill: `tomevault-io/obsidian-theme-dev` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/obsidian-theme-dev`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/obsidian-theme-dev/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/obsidian-theme-dev

---


# Obsidian Theme Development Skill

This skill provides patterns and rules for developing Obsidian themes, focusing on CSS/SCSS development, styling conventions, and theme-specific coding practices.

## Purpose

To ensure consistent theme development, proper CSS organization, and adherence to Obsidian's theming patterns and CSS variable usage.

## When to Use

Load this skill when:
- Writing or modifying CSS/SCSS for `theme.css`
- Working with Obsidian's CSS variables and theming system
- Implementing responsive design or dark/light mode support
- Debugging CSS layout or styling issues
- Following CSS/SCSS coding conventions

## Core Rules

- **Use Obsidian CSS Variables**: Always prefer Obsidian's built-in CSS variables over hardcoded values
- **Follow BEM Methodology**: Use Block-Element-Modifier naming for CSS classes
- **Mobile-First**: Consider mobile layouts and responsive design
- **Dark/Light Mode Support**: Test themes in both light and dark modes
- **Performance**: Minimize CSS complexity and avoid expensive selectors

## Bundled Resources

- `references/theme-best-practices.md`: Essential CSS patterns and Obsidian variable usage
- `references/theme-coding-conventions.md`: CSS/SCSS style guidelines and naming conventions

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/davidvkimball) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

