Menu
Přihlásit
Článek Claude Code

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.

Aktualizováno Publikováno 8 min čtení 12 sekcí

Obsah článku 12 sekcí

V kostce

  • Obsidian Skills je oficiální balíček sedmi skills od Obsidianu (MIT licence), který funguje v Claude Code, Codex, Cursor i OpenCode.
  • Pokrývá Markdown, Bases (.base), JSON Canvas (.canvas), CLI, headless sync a publish přes ob, extrakci webu (Defuddle) a šablony (Knap).
  • Headless Sync i Publish vyžadují aktivní předplatné; nástroj ob běží na Node.js 22+ a nepotřebuje desktopovou aplikaci.
  • Před prvním sync zálohuj vault a nemíchej desktop Sync s headless Sync na stejném zařízení.
Obsidian Skills 1.2: nech Claude Code spravovat tvůj vault - ilustrační obrázek

Obsidian Skills je oficiální balíček sedmi dovedností (skills), kterými Obsidian naučí AI agenty pracovat s tvým vaultem. Podporuje Claude Code, 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, 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, takže funguje v jakémkoliv agentovi, který ji podporuje. Všechno je na GitHubu v repozitáři 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íš:

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:

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:

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. 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.

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:

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íš:

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:

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 (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, 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é:

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 nebo Blender skills pro Claude Code a Codex. 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.

Smysl dává i pohled na srovnání subagentů a skills – 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 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.

Ušetřete

  • Anthropic: 6 měsíců Claude Ultra zdarma (v hodnotě 1 200 $) — zobrazit výhodu
  • Anthropic: API kredity na Claude zdarma (výše podle projektu) — zobrazit výhodu
  • Anthropic: Claude Team od 8 $ za uživatele měsíčně (3 $ v zemích s nižšími příjmy) — zobrazit výhodu

Další AI kredity a slevy →

Zmíněné AI nástroje

Pokračuj dál

Všechny články →