Obsidian Theme — Skill de Criação e Edição de Temas
sonjh919/obsidian-theme
Crie e customize temas Obsidian por descrição em linguagem natural
Ver no GitHubSkill para Claude Code que permite criar, editar e alternar temas do Obsidian usando linguagem natural, sem necessidade de conhecimento de CSS. Oferece três modos: criação de novos temas por descrição de mood, edição de temas existentes com mapeamento automático de variáveis CSS, e alternância entre temas instalados.
Instalação
npx convez-ai sonjh919/obsidian-theme1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar temas visuais personalizados para Obsidian sem escrever CSS
- Ajustar cores, fontes e espaçamento de um tema existente via descrição textual
- Gerenciar múltiplos temas e alternar entre eles sem linha de comando
Veredito

Skill bem estruturado que democratiza customização de temas Obsidian para usuários sem expertise em CSS. Implementação sólida com detecção automática de vault, mapeamento validado de variáveis CSS e proteção contra sobrescrita de temas externos — ideal para produtividade visual.
README
A tradução para o português deste README ainda está na fila.
obsidian-theme
A Claude Code skill that lets you create, edit, and switch Obsidian themes using natural language — no CSS knowledge required.
"따뜻한 카페" → a full Obsidian theme. "코드블록 배경 좀 더 어둡게" → live diff and apply.
What it does
Three modes, picked at invocation time:
- 새로 (Create) — Describe a mood in plain language. The skill suggests 3 palette candidates from a curated catalog, asks 4 quick questions (light/dark, font, corner radius, spacing), and writes a complete theme into your vault's
.obsidian/themes/<name>/. - 수정 (Edit) — Tell it what to change ("link color to orange"). It maps your words to the right CSS variables (using a cheatsheet validated against Obsidian's official docs), shows a diff, applies it. External themes (AnuPpuccin etc.) are never modified — they get a snippet override instead.
- 스위치 (Switch) — Lists all themes in your vault. Pick one, it patches
appearance.json. CLI-only theme switching.
The skill never overwrites an existing theme. New themes are added under fresh names so multiple themes coexist in your vault.
Install
# Clone into your Claude Code skills directory
git clone https://github.com/sonjh919/obsidian-theme.git ~/.claude/skills/obsidian-theme
That's it. Claude Code auto-discovers skills under ~/.claude/skills/.
To update later:
cd ~/.claude/skills/obsidian-theme && git pull
Usage
In Claude Code, invoke with any of:
/obsidian-theme- "옵시디언 테마 만들어줘"
- "테마 바꿔줘"
- "옵시디언 꾸미기"
The skill will:
- Find your vault (scans
~/Documentsand~; if multiple, you pick) - Ask which mode (스위치 / 새로 / 수정) — vault state determines the recommended default
- Walk you through that mode's flow
Example session — Create
You: /obsidian-theme
Skill: 어떤 작업을 할까요?
1. 스위치 — 만들어둔 테마들 중 하나로 갈아끼기
2. 새로 — 자연어 묘사로 새 테마 만들기 (추천)
3. 수정 — 현재 테마의 일부를 자연어로 튜닝
You: 2
Skill: 어떤 느낌의 테마를 원하세요?
You: 따뜻한 카페 같은 느낌
Skill: 세 가지 팔레트 후보예요. 어느 게 가장 가까워요?
[1] warm-cafe ☕ 배경 #f7f1e8 · 액센트 #c97b3b
[2] sunset-warm 🌅 배경 #1f1410 · 액센트 #ff8847
[3] (즉석) 배경 #faf3e7 · 액센트 #d4925c
You: 1
Skill: 네 가지만 더 정해주세요.
Q1. 라이트 / 다크 / 둘 다 → 둘 다
Q2. 폰트 → Serif
Q3. 모서리 → 8px
Q4. 간격 → 보통
Skill: ✅ 테마 "warm-cafe" 생성 완료
📂 <vault>/.obsidian/themes/warm-cafe/theme.css
🎨 appearance.json 패치 완료 — 옵시디언에서 즉시 확인하세요
What's inside
obsidian-theme/
├── SKILL.md # Routing entry — vault detection + 3-mode branch
├── create-flow.md # New theme bootstrap (7 steps)
├── edit-flow.md # Existing theme tuning (5 steps)
├── switch-flow.md # Theme switching (3 steps)
├── variables.md # CSS variable cheatsheet + natural-language mapping
│ # Cross-validated against docs.obsidian.md
└── palettes.md # 14-mood palette catalog (warm-cafe, retro-terminal,
# nordic-cold, sakura, dracula, tokyo-rain, …)
Design choices
- Single full theme as the unit, not multiple snippets. Cleaner for users starting from scratch.
- Never overwrite — new themes get fresh names; old themes stay in the
themes/folder so you can A/B compare. - External themes are sacred — edits to AnuPpuccin, Minimal, etc. go into a separate snippet (
.obsidian/snippets/obsidian-theme-override.css), leaving the original untouched. - Marker header (
/* obsidian-theme: managed */) on every generated theme so edit-mode can distinguish "ours" from "yours." - HSL accent system — uses Obsidian's
--accent-h/s/lso the rest (--interactive-accentetc.) auto-derives. - Routing-only SKILL.md (~80 lines), heavy content lazy-loaded from flow/catalog files. Keeps first-invocation context cheap.
Caveats
- Cascade priority: if your vault has many CSS snippets active (or
textFontFamily/interfaceFontFamilyset inappearance.json), they can override theme CSS. On a clean vault, themes apply 100% as intended. Seevariables.mdfor details. - Obsidian must be running for hot reload. Otherwise changes apply on next launch.
- Tested on: macOS, Obsidian 1.x. Should work cross-platform but Windows/Linux paths in flow files assume Unix
find.
Requirements
- Claude Code
- Obsidian 1.0+
- Bash (macOS/Linux). Windows users may need to adjust path handling.
License
MIT — see LICENSE.
Contributing
Issues and PRs welcome. Especially:
- More moods for
palettes.md - Additional CSS variables for
variables.md(with docs.obsidian.md cross-reference) - Windows path compatibility
- Image-upload mode (color extraction from reference screenshots)