.claude/skills/<jméno>/SKILL.md
Skill
Stabilní znalost nebo styl — bento design, firemní copy, formát reportu. Agent si ho sám zavolá podle popisu.
Jeden prompt, pět nástrojů, žádný kód. Postavíte si travel dashboard, kde Claude Code přečte vaše pravidla, analyzuje fotky, najde letenky přes API, zjistí počasí z webu a složí to do HTML stránky — sám.
Každý blok má jasný zdroj — odkud Claude bere data. Vpravo je označení, jaký nástroj (soubor, subagent, MCP, web search) blok naplnil.
Velká myšlenka: V Levelu 1 jste agenta poprosili o jeden úkol. V Levelu 2 jste viděli celé workflow. Teď Level 3 — Claude Code čte pravidla, dívá se na fotky, volá letové API, hledá počasí na webu, staví dashboard a po dokončení sám otevře prohlížeč. Tohle je orchestrace.
Nahrávka z webináře: Tuhle část jsme na živém webináři nestihli probrat do detailu. Poslechněte si kompletní popis celého Levelu 3 na Supercutu — Slava prochází orchestraci krok po kroku, tak jak jste ji měli slyšet živě.
Než začnete sami, můžete se podívat na video, kde Slava z Aibility celý Level 3 prochází krok za krokem — od přípravy přes subagenta a hook až po hotový dashboard.
Přehrát walkthrough
Všechno potřebné je připravené ve složce level-3-advanced/demo-files/ v repozitáři webináře. Podívejte se, co tam je:
MCP (Model Context Protocol) propojí agenta s externí službou. V tomhle případě s vyhledáváním letenek od Kiwi.com. Žádný API klíč, žádná registrace. Řekněte Claude Code:
Potřebuju přidat MCP server na vyhledávání letenek od Kiwi.com. Nainstaluj ho za mě.
CLAUDE.md je soubor, který agent přečte pokaždé, když ho spustíte. Je to mapa vašeho projektu — říká agentovi, kde co najde, jaká pravidla platí a jak se má chovat. Bez mapy agent bloudí a hádá. S mapou ví přesně, co od něj chcete.
Princip harness engineering: Agent = model + harness. Model je mozek, harness je všechno ostatní — pravidla, kontext, nástroje, testy. CLAUDE.md je srdce toho harnesse. Čím lepší mapu agentovi dáte, tím méně ho musíte hlídat. Martin Fowler tomu říká „feedforward control" — předáváte agentovi zkušenosti svého týmu, než začne pracovat.
Ve složce demo-files/ je připravený CLAUDE.md s tímhle obsahem:
# Pravidla projektu
## Travel preferences
- Odlet: pátek po 16:00, návrat neděle do 22:00
- Budget: strop 12000 Kč za zpáteční letenku
- Preferuju přímé lety (pokud není přímý do budgetu, s přestupem ok)
- Home airport: Praha (PRG)
## Jak pracuješ
- Piš vždy česky
- Než cokoli upravíš nebo napíšeš, nejdřív si přečti
relevantní soubory a ověř si aktuální fakta.
Nikdy si nevymýšlej z paměti.
Klíčový princip: „Agent musí číst, ne hádat." Ta poslední sekce je nejdůležitější věta celého průvodce. Jedna instrukce v CLAUDE.md dramaticky snižuje halucinace — agent vychází z toho, co přečte, ne z toho, co si „pamatuje".
Dva typy CLAUDE.md:
Projektový (./CLAUDE.md) — pravidla pro konkrétní projekt, sdílí se s týmem přes Git.
Osobní (~/.claude/CLAUDE.md) — vaše globální preference, platí pro všechny projekty.
Agent si oba zkombinuje.
Subagent je specializovaný agent, kterého si hlavní Claude sám zavolá pro podúkol. Postavíte ho jedním promptem — je to jeden markdown soubor.
Tenhle prompt vytvoří subagenta, který umí analyzovat fotky jako detektiv:
Vytvoř subagenta v .claude/agents/foto-detektiv.md. Role: destinační detektiv ve stylu Sherlocka Holmese. Dostane složku s fotkami, hledá stopy (architektura, vegetace, světlo, nápisy, jídlo) a navrhne 2–3 kandidátní destinace s verdiktem. Česky, teatrálně, ale opřený o konkrétní stopy. Barva fialová. Každou odpověď začíná ASCII bannerem s lupou.
.claude/agents/foto-detektiv.md s frontmatterem (name, description, tools, color) a tělem s instrukcemi. Hlavní agent si ho za chvíli sám najde podle popisu.Princip: Subagent je Claude, kterého si váš hlavní Claude zavolá. Vlastní role, vlastní kontext, vlastní tón. Celý subagent je jeden markdown — žádná instalace, žádná kompilace.
Hook je automatická akce, která se spustí v určitém momentě. Tenhle hook otevře dashboard v prohlížeči pokaždé, když agent zapíše HTML soubor.
Tenhle prompt nastaví automatizaci:
Přidej do .claude/settings.json hook: pokaždé, když zapíšeš HTML soubor do vystupy/, otevři ho v prohlížeči a český hlas "Zuzana" nahlas řekne "Dashboard je připraven, koukej do prohlížeče". Použij PostToolUse matcher "Write".
.claude/settings.json s pár řádky JSON. Matcher na nástroj Write je spolehlivější než grepovat transcript — hook se spustí deterministicky.Tady se všechno spojí. Jeden prompt, který využije CLAUDE.md, subagenta, fotky, Kiwi MCP, web search, design skill i hook.
Tohle je ten hlavní prompt. Zkopírujte ho celý:
Postav mi travel dashboard.
Podívej se na fotky v wishlist/ a přečti wishlist.md. Přečti moje travel preferences z CLAUDE.md.
1. Z fotek odhadni destinaci — navrhni 2–3 varianty, které sedí, a vyber tu nejlepší podle mých preferencí.
2. Pro vybranou destinaci najdi přes Kiwi MCP nejlepší let z mého home airportu na příští víkend.
3. Vytvoř vystupy/travel-planner.html — dashboard s výsledky letu, počasím (web search), plánem aktivit podle mých fotek a praktickými tipy pro konkrétní destinaci (transport z letiště, MHD, dýško, místní fráze, co obejít).
Design: použij bento design skill, ale přitáhni to o level výš — wow efekt, ne jen hezké kartičky:
– nahoře hero carousel s fotkami z wishlist/ (auto-play, jemný Ken Burns zoom, plynulý fade, popisek „co na téhle fotce sedí na destinaci")
– scroll-driven reveal animace u karet
– živý detail: odpočet do odletu, teploměr s aktuální teplotou, mapka trasy letu (SVG oblouk PRG→LIS)
– typografie: velký serif display na čísla, drobný mono na letové kódy, vzdušné mřížky
– všechno v jednom .html souboru, inline CSS + JS, žádné externí závislosti kromě Google Fonts
Slash command je opakovatelný workflow za lomítkem. Napíšete /pohlednice a Claude vám napíše pohlednici „z dovolené" na základě hotového dashboardu.
Tenhle prompt vytvoří slash command:
Vytvoř slash command v .claude/commands/pohlednice.md. Command se jmenuje "pohlednice". Když ho spustím, přečte vystupy/travel-planner.html a napíše 5–8řádkovou pohlednici "z dovolené" — česky, osobně, jako bych tam skutečně byl. Použij konkrétní detaily z dashboardu (destinace, jídlo, místa). Přidej jednu drobnou smyšlenost a na konci PS, kde tu lež žertovně prozradíš. Volitelný argument: adresát (např. "mamce") — pokud je, oslov ho na začátku.
.claude/commands/pohlednice.md. Teď stačí napsat /pohlednice (nebo /pohlednice mamce) a Claude napíše hravou pohlednici s jednou drobnou lží prozrazenou v PS.
Skill, subagent, slash command — každý z nich řeší jinou potřebu, ale všechny sdílí stejný princip: jeden markdown soubor ve složce .claude/. Vyberete si, co vám sedí, napíšete markdown, máte napořád.
.claude/skills/<jméno>/SKILL.md
Stabilní znalost nebo styl — bento design, firemní copy, formát reportu. Agent si ho sám zavolá podle popisu.
.claude/agents/<jméno>.md
Specializovaná role — foto-detektiv, code reviewer. Vlastní kontext, vlastní tón. Hlavní Claude ho deleguje.
.claude/commands/<jméno>.md
Opakovaný workflow — /pohlednice, /tydennireport. Voláte ho lomítkem, přijímá argumenty.
Žádná instalace, žádná kompilace. Napíšete markdown — ideálně necháte Claude napsat první verzi podle popisu — a máte nové schopnosti navždy. Tohle je ten „velký důsledek", o kterém se v Claude Code mluví nejvíc: všechno je markdown.
Claude Code umí běžet na různých modelech. Přepnete kdykoli příkazem /model:
Nejrychlejší, nejlevnější. Pro jednoduché úkoly — přečíst soubor, najít text, drobná úprava.
Triviální úkol? Haiku.
Výchozí volba pro 90 % práce. Dobrý poměr rychlosti a kvality.
Výchozí. Začněte tady.
Nejschopnější. Složité plánování, velké refaktory, strategické rozhodování.
Claude tápe? Přepněte na Opus.
Pravidla přes CLAUDE.md. Subagent na analýzu fotek. Reálná data z Kiwi přes MCP. Počasí z webu. Automatické otevření přes hook. Slash command na pohlednici. Každý dílek je jednoduchý. Dohromady je to orchestr.
dirigent · jeden prompt
Každý dílek je jednoduchý. Dohromady je to orchestr.
Všechno je markdown. Všechno se staví promptem. Claude Code je dirigent.
CLAUDE.md není jen pro cestování. Tady jsou příklady pro marketéry a projektové manažery — upravte si je podle sebe.
# Marketing projekt
## Styl obsahu
- Tón: profesionální ale přístupný
- Cílová skupina: malé a střední firmy
- Jazyk: čeština, žádné anglicismy pokud existuje český ekvivalent
- Formát: krátké odstavce, bullet pointy, jasné CTA
## Pravidla
- Každý text musí mít hook v první větě
- LinkedIn příspěvky max 1300 znaků
- Email subject lines max 50 znaků
## Než něco napíšeš
- Když píšeš o produktu nebo trendu, nejdřív si ověř
aktuální fakta přes web search. Nepiš ze své paměti.
- Když navazuješ na předchozí kampaň, nejdřív si ji přečti.
# PM workspace
## Výstupy
- Vždy strukturované: problém → analýza → doporučení
- Tabulky pro porovnání variant
- Timeline s milníky u plánů
- Rizika vždy s pravděpodobností a dopadem
## Formát
- Reporty v Markdown
- Executive summary na začátku každého dokumentu
## Než něco navrhneš
- Nejdřív si přečti zadání projektu a předchozí reporty
- Když se odkazuješ na data, ověř si je — neuvádíš čísla z paměti
Harness engineering učí, že dobrý CLAUDE.md má tři vlastnosti:
/init — agent vytvoří základ z obsahu vaší složky. Pak ho postupně vylepšujte: když agent udělá chybu, přidejte pravidlo, které jí příště zabrání.
Více o harness engineering: Martin Fowler · Latent Space