# Obsidian Skills 1.2: nech Claude Code spravovat tvůj vault

> Obsidian Skills jsou oficiální dovednosti, které naučí Claude Code, Codex i Cursor spravovat tvůj vault: Bases, Canvas, headless sync a čistý Markdown.

Canonical: https://aicko.cz/content/obsidian-skills-claude-code-vault
Last updated: 2026-11-18
Kategorie: Claude Code

Obsidian Skills je oficiální balíček sedmi dovedností (skills), kterými Obsidian naučí AI agenty pracovat s tvým vaultem. Podporuje [Claude Code](https://aicko.cz/content/claude-code-video-jako-kod-workflow-tensaikuna-a-videohub), Codex i Cursor, funguje lokálně a pokrývá Markdown, Bases, Canvas, headless sync přes `ob`, extrakci webu přes Defuddle a šablony přes Knap. Balíček je MIT licencovaný a v hlavní větvi je na verzi 1.2.0 (poslední tagovaný release je 1.1.0 z 11. 11. 2026). Ověřeno 15. 11. 2026.

Nejde o žádný MCP server ani o běžící službu na pozadí. Je to sada textových instrukcí, které agentovi vysvětlují formáty souborů a příkazy, aby ti nerozbil poznámky. V tomhle článku ukážu, co každá ze sedmi skills umí, jak balíček nainstaluješ do [Claude Code](https://aicko.cz/content/kolik-stoji-claude-code-2026), Codex i Cursor, a jak z toho složíš praktický workflow – od převedení webového článku na poznámku až po synchronizaci vaultu ze serveru bez desktopové aplikace.

## Co přesně Obsidian Skills umí

Balíček vychází z otevřené specifikace [Agent Skills](https://aicko.cz/content/dependabot-pro-agent-skills-verzovani-pres-apm), takže funguje v jakémkoliv agentovi, který ji podporuje. Všechno je na [GitHubu v repozitáři obsidianmd/obsidian-skills](https://github.com/obsidianmd/obsidian-skills) (přístup 15. 11. 2026) a Obsidian v dokumentaci zmiňuje Claude Code, Codex a OpenCode; Cursor balíček nabízí ve svém marketplace. Sedm skills pokrývá:

| Skill | K čemu slouží | Kdy ho agent použije |
|---|---|---|
| obsidian-markdown | Obsidian Flavored Markdown: wikilinky, embedy, callouty, properties | Když píše nebo upravuje `.md` soubory |
| obsidian-bases | Soubory Bases (`.base`): views, filtry, formule, souhrny | Když pracuje s databázemi v Obsidianu |
| json-canvas | JSON Canvas (`.canvas`): uzly, hrany, skupiny, propojení | Když vytváří vizuální plátna a myšlenkové mapy |
| obsidian-cli | Obsidian CLI: čtení, tvorba, hledání a správa poznámek | Když ovládá běžící desktopovou aplikaci |
| obsidian-headless | Sync a Publish z příkazové řádky přes `ob` | Když synchronizuje vault bez desktop appky |
| defuddle | Čistý Markdown z HTML stránek | Když převádí webový článek na poznámku |
| knap | Markdown ze šablon a JSON/CSV dat | Když generuje poznámky dávkově |

Důležité je, že skills jsou jen instrukce, nikoliv aplikace. Agent si je přečte a podle nich volá existující nástroje – Obsidian CLI, `ob`, Defuddle a Knap. Skills před použitím kontrolují, jestli je nástroj nainstalovaný (třeba `defuddle --help` nebo `ob --help`), a když chybí, agent ti instalaci nabídne místo toho, aby předstíral úspěch.

## Instalace do Claude Code, Codex a Cursor

Nejjednodušší cesta pro Claude Code je přes plugin marketplace. V terminálu spustíš:

```bash
claude plugin marketplace add obsidianmd/obsidian-skills
claude plugin install obsidian@obsidian-skills
```

Pro Codex stačí přidat marketplace a plugin nainstalovat z adresáře:

```bash
codex plugin marketplace add obsidianmd/obsidian-skills
```

Cursor balíček nabízí přímo ve svém marketplace pod názvem Obsidian – žádný příkaz k tomu není potřeba. Univerzální varianta přes `npx` funguje pro cokoliv, co umí [Agent Skills](https://aicko.cz/content/pstack-lauren-tan-agent-skills):

```bash
npx skills add https://github.com/obsidianmd/obsidian-skills
```

Pokud chceš instalovat ručně, nakopíruj složku `plugins/obsidian/skills/` do `.claude/skills/` v kořenu vaultu (Claude Code) nebo do cesty skills pro Codex (typicky `~/.agents/skills`). U OpenCode musíš klonovat celý repozitář, ne jen vnitřní složku – skills se objeví po restartu.

## Obsidian CLI: agent ovládá běžící aplikaci

Skill `obsidian-cli` používá příkaz `obsidian`, který se instaluje spolu s Obsidianem a komunikuje s **běžící** desktopovou aplikací. Pokud CLI není aktivní, je potřeba ho zapnout podle [oficiální dokumentace](https://help.obsidian.md/cli). Tohle je skill pro případ, kdy máš Obsidian otevřený a chceš, aby agent přidával poznámky rovnou do spuštěného vaultu.

```bash
obsidian create name="Schůzka 2026-11-15" content="Agenda a výstupy"
obsidian read file="Můj projekt"
obsidian search query="rozpočet"
```

Dvě pastičky, na které se vyplatí myslet. Zaprvé: `obsidian` vrací exit status 0, i když příkaz selže – takže agent musí číst výstup, ne jen návratový kód. Zadruhé: v `content=` se `\n` a `\t` převádí na nový řádek a tabulátor, takže obsah s LaTeXem (třeba `\theta`) nebo cestou `C:\notes` se poškodí. Obsah delší než zhruba 4 KB je lepší psát přímo do souboru.

## Headless sync: `ob` bez desktopové aplikace

Tohle je nejzajímavější část pro automatizaci. Skill `obsidian-headless` používá nástroj `ob`, který synchronizuje a publikuje vault z příkazové řádky – žádná desktopová aplikace není potřeba, takže to běží na serveru, v CI nebo v sandboxu. Je v otevřené betě a vyžaduje Node.js 22 nebo novější. Instalace:

```bash
npm install -g obsidian-headless
```

Sync i Publish přitom **vyžadují aktivní předplatné** na účtu Obsidianu. Nejdřív se přihlásíš přes `ob login`, pak vault připojíš:

```bash
ob sync-list-remote
ob sync-setup --vault "Research" --path ~/vaults/research
ob sync --path ~/vaults/research
```

Pro průběžnou synchronizaci existuje `--continuous` – spouští se na pozadí nebo jako služba. Publikování funguje podobně, ale publikují se jen poznámky s vlastností `publish: true`:

```bash
ob publish-setup --site my-notes --path ~/vaults/research
ob publish --path ~/vaults/research --dry-run
ob publish --path ~/vaults/research --yes
```

Jedno varování z dokumentace: **nepoužívej desktop Sync a Headless Sync na stejném vaultu a stejném zařízení zároveň** – způsobují konflikty. A před prvním sync si vault zálohuj. Podrobnosti najdeš v [dokumentaci Headless](https://help.obsidian.md/headless) (přístup 15. 11. 2026).

## Bases a Canvas: databáze a plátna jako soubory

Skills `obsidian-bases` a `json-canvas` řeší to, co dřív uměla jen aplikace – formáty `.base` a `.canvas` jsou totiž otevřené textové soubory. Agent je dokáže vytvářet a upravovat, aniž by musel klikat v GUI.

`obsidian-bases` pracuje se soubory `.base`, které definují databázové pohledy na poznámky: tabulku, karty (cards), seznam, mapu nebo nově kanban (vyžaduje Obsidian 1.14+ a groupBy; přetažení karty do jiného sloupce změní property v poznámce), plus filtry, formule a souhrny. `json-canvas` zase generuje soubory `.canvas` s uzly, hranami, skupinami a propojeními – formát je specifikovaný na [jsoncanvas.org](https://jsoncanvas.org), takže plátno vytvořené agentem otevřeš v Obsidianu a naopak.

## Defuddle a Knap: web do poznámky, data do šablony

Dvojice pro „nasávání" obsahu. Defuddle vytáhne z webové stránky čistý Markdown – odfiltruje navigaci, reklamy a balast, takže do poznámky jde jen obsah. Instaluje se přes `npm install -g defuddle` a použití je jednořádkové:

```bash
defuddle parse https://example.com/clanek --md
```

Knap pak vezme šablonu a strukturovaná data (JSON nebo CSV) a vygeneruje z nich Markdown – hodí se pro dávkové poznámky nebo pro přeformátování výstupu z Defuddle do podoby, kterou máš ve vaultu.

## Praktický workflow: z článku na webu do strukturované poznámky

Slož to dohromady a dostaneš postup, který ušetří hodiny ručního přepisování. Řekneš Claude Code:

> „Převeď tenhle článek na poznámku do mého vaultu. Vytáhni čistý text, shrň ho do šablony a ulož s properties podle mých pravidel."

Agent to rozloží takhle:

1. **Defuddle** stáhne čistý Markdown z URL: `defuddle parse <url> --md`.
2. **Knap** vyrenderuje poznámku z tvé šablony a vloží do ní obsah.
3. **obsidian-markdown** zajistí správné wikilinky, callouty a properties.
4. **obsidian-cli** poznámku zapíše do běžící aplikace (nebo **obsidian-headless** rovnou synchronizuje na server).

Stejný princip platí pro databázi kontaktů v `.base` nebo myšlenkovou mapu projektu v `.canvas`. Agent nepotřebuje žádný import – píše přímo do formátů, kterým Obsidian rozumí.

## Druhý příklad: databáze klientů v Bases

Bases jsou databázové pohledy nad poznámkami, takže se hodí i na evidenci klientů nebo projektů. Řekneš agentovi: „Vytvoř `.base` soubor s klienty – tabulka se sloupci jméno, firma, stav a termín další schůzky, plus filtr na otevřené případy."

Agent podle skillu `obsidian-bases` vygeneruje soubor, který definuje pohled tabulky, sloupce z properties a filtr. Výsledek otevřeš v Obsidianu a vidíš stejnou tabulku, jakou bys ručně naklikal – jen vznikla z promptu. Formule a souhrny (třeba počet klientů ve stavu „čeká na odpověď") doplníš stejným způsobem, bez psaní syntaxe.

U `.canvas` je to podobné: „Nakresli mapu projektu s uzly pro fáze a propoj je hranami podle závislostí." Agent zapíše uzly, hrany a skupiny do `.canvas` souboru, a ty ho pak můžeš ručně doladit myší.

## Srovnání s dalšími skills pro agenty

Obsidian Skills nejsou jediný oficiální balíček, který agenta učí práci s konkrétním nástrojem. Stejným principem funguje [n8n Skills pro Claude Code](https://aicko.cz/content/n8n-skills-pro-claude-code-oficialni-balicek-a-mcp) nebo [Blender skills pro Claude Code a Codex](https://aicko.cz/content/blender-skills-pro-claude-code-a-codex-3d-pipeline-agenta). Rozdíl je v tom, co řeší: n8n učí agenta sestavovat automatizace, Blender 3D pipeline a Obsidian práci se znalostní bází. Pokud chceš pochopit, jak skills fungují obecně a kdy se vyplatí je psát vlastní, začni u [návodu na Claude Skills](https://aicko.cz/content/claude-skills-navod-vlastni-dovednosti-agenta).

Smysl dává i pohled na [srovnání subagentů a skills](https://aicko.cz/content/subagenti-vs-skills-kdy-agenty-slozit-do-jedne-smycky) – Obsidian Skills jsou přesně ten případ, kdy skills stačí: žádný samostatný agent, jen instrukce, které se přiloží k tomu, co už umí Claude Code.

## Na co si dát pozor

**Soukromí.** Skills běží lokálně jako instrukce, ale cokoliv necháš agenta přečíst nebo upravit, se odešle poskytovateli modelu – to je princip každého agentního skillu, ne něco specifického pro Obsidian. Citlivé poznámky si hlídej sám.

**Backup před prvním sync.** Headless Sync píše do vzdáleného vaultu. Než poprvé spustíš `ob sync`, zálohuj složku vaultu.

**Nezaměňuj desktop a headless.** Desktop Sync a `ob` na stejném vaultu a zařízení zároveň = konflikty. Vyber si jednu cestu.

**Čti výstup, ne exit code.** Obsidian CLI hlásí úspěch i při chybě. Agent by měl číst text výstupu.

## Časté otázky

### Je Obsidian Skills zdarma?

Ano, balíček je MIT licencovaný a instrukce samotné nic nestojí. Platíš jen služby, které používáš: Obsidian Sync a Publish vyžadují aktivní předplatné, a samotný chod agenta spotřebovává kredity u poskytovatele modelu.

### Potřebuji Obsidian desktop aplikaci?

Pro `obsidian-cli` ano, musí běžet. Pro `obsidian-headless` ne – `ob` synchronizuje a publikuje bez desktopové aplikace (stačí Node.js 22+). Soubory `.md`, `.base` a `.canvas` může agent upravovat rovnou, bez aplikace.

### Funguje to i v Cursoru?

Ano. Obsidian Skills je jeden plugin publikovaný pro Claude Code, Codex i Cursor. V Cursoru ho nainstaluješ z marketplace, v Claude Code přes `claude plugin install obsidian@obsidian-skills`.

### Může agent smazat moje poznámky?

Může, stejně jako ty – skills mu dávají instrukce, ne oprávnění. Agent pracuje jen s tím, co mu zadáš, a než spustíš první headless sync, dokumentace doporučuje zálohu. Pro jistotu můžeš [nechat agenta](https://aicko.cz/content/codex-cloud-jak-nechat-ai-agenta-kodovat-v-cloudu) nejdřív pracovat v kopii vaultu.

### Jaký je rozdíl mezi Obsidian Skills a MCP serverem?

Obsidian Skills jsou jen textové instrukce podle specifikace Agent Skills – žádný MCP server, hook ani proces na pozadí. MCP server je samostatná služba s vlastním rozhraním. Tady nic navíc neběží; agent volá existující CLI nástroje.

## Verdikt

Obsidian Skills 1.2 je nejužitečnější pro lidi, kteří už vault používají jako druhou paměť a chtějí, aby jim s ním pomáhal agent – ať už jde o hromadné převádění článků na poznámky, generování databází v Bases, nebo synchronizaci vaultu na server bez desktopové aplikace. Není to MCP server ani „AI v Obsidianu", je to sada návodů, díky které agent konečně ví, jak formáty Obsidianu fungují. Pokud už jedeš v Claude Code, Codex nebo Cursoru, instalace je otázka jednoho příkazu.

## Related

- [Obsah: Claude Code](https://aicko.cz/obsah/claude-code)
- [Claude AI](https://aicko.cz/ai-tools/claude)
- [OpenCode](https://aicko.cz/ai-tools/opencode)
- [n8n](https://aicko.cz/ai-tools/n8n)
- [Cursor](https://aicko.cz/ai-tools/cursor)
- [Claude Code](https://aicko.cz/ai-tools/claude-code)

---
Zdroj: AIčko.cz. Při citaci uveďte název webu a odkaz na https://aicko.cz/content/obsidian-skills-claude-code-vault
