⌂
Základy

Co je skill?

Skill = složka s instrukcemi, jak má Claude řešit konkrétní typ úlohy

Skill je jako pracovní postup zachycený v souboru. Místo abyste pokaždé vysvětlovali Claudovi "jak dělat X", skill to ví předem — a Claude ho použije automaticky, jakmile rozpozná, že se hodí.

Skill = složka nazev-skillu/ s jedním povinným souborem SKILL.md a volitelnými zdroji.
Definice ze skill-creator dokumentace
📁 muj-skill/
📄 SKILL.md # povinný
📁 scripts/ # spustitelný kód
⚙️ generate.py
⚙️ validate.js
📁 references/ # dokumentace
📖 api-docs.md
📖 schemas.md
📁 assets/ # soubory výstupu
🖼️ template.docx
🎨 icons/

📄 SKILL.md — povinný

Obsahuje YAML frontmatter (name, description) a instrukce v Markdownu. Claude ho čte pokaždé, když skill použije. Ideálně pod 500 řádků.

⚙️ Scripts — spustitelný kód

Skripty pro opakující se nebo deterministické úlohy. Claude je spustí místo toho, aby vymýšlel kód sám — šetří čas a je konzistentnější.

📖 References — dokumentace

Velké referenční soubory (API docs, schémata). Načtou se jen když jsou potřeba, ne pokaždé. Vhodné pro věci přes 300 řádků.

🎨 Assets — šablony a soubory

Soubory které skill přímo používá ve výstupu — Word šablony, ikonky, fonty, obrázky.

Jak vypadá SKILL.md uvnitř
--- ← YAML frontmatter (vždy nahoře) name: veda-vs-media description: Vytvoří slajdy Feynman/Tufte stylu pro debunking vědeckých mýtů. Použij kdykoliv uživatel chce rozebrat vědeckou studii, odhalit bias v médiích, nebo vytvořit příklad otázka→důkaz→shrnutí. --- ← konec frontmatteru # Veda vs Media Skill ## Co dělá Přijme claim nebo studii → vygeneruje strukturované slajdy (PPTX) se strukturou: OTÁZKA → DŮKAZ → SHRNUTÍ ## Kdy použít - Uživatel říká "rozeber tu studii", "udělej slajdy o X" - Chce ukázat rozdíl mezi mediálním titulkem a vědeckou realitou ## Postup 1. Přečti references/color-palette.md pro barvy 2. Spusť scripts/generate_slides.js s daty 3. Ulož do outputs/ a dej odkaz uživateli
Mechanismus

Jak se skill spouští?

Tříúrovňový systém načítání — od metadat po velké referenční soubory

Claude vždy vidí seznam dostupných skillů s jejich názvy a popisy. Na základě toho rozhodne, jestli skill použije. Pak načte jen tolik, kolik potřebuje.

1
Metadata (name + description)
Vždy v kontextu. Tohle Claude čte, aby rozhodl jestli skill použít. ~100 slov. Klíčové pro správné spouštění.
✅ Vždy načteno
2
SKILL.md tělo
Instrukce, postup, příklady. Načte se pokaždé, když Claude rozhodne skill použít. Ideálně <500 řádků.
⚡ Při spuštění
3
Scripts, References, Assets
Velké soubory, API dokumentace, šablony. Načtou se jen když je skill explicitně potřebuje. Žádný limit.
📂 Na vyžádání
Tok od uživatelského promptu po výsledek
Uživatel napíše prompt
→
Claude čte seznam skillů (metadata)
→
Skill odpovídá? → načte SKILL.md
→
Provede postup (+ skripty/reference dle potřeby)
→
Výsledek uživateli
Klíčová poučka: description v SKILL.md frontmatteru je primární spouštěcí mechanismus. Špatný popis = skill se nespustí i když by měl.
Skill Creator dokumentace
Jak vytvořit nový skill

Skill Creator — celý workflow

Od nápadu po otestovaný, zabalený skill

Krok 1
✍️
Napiš SKILL.md
Name, description, postup, příklady. Zjisti edge-cases od uživatele.
Krok 2
🧪
Spusť testy
2–3 reálné prompty. Paralelně: s skillem i bez (baseline).
Krok 3
📊
Ohodnoť a benchmarkuj
Kvantitativní asserty + čas + tokeny. Agreguj do benchmark.json.
Krok 4
👁️
Eval Viewer
Uživatel projde výsledky, napíše feedback na každý test case.
Krok 5
🔄
Iteruj → opakuj
Vylepši skill, spusť znovu s --previous-workspace. Dokud není dobré.
evals/evals.json — testovací sada
{ "skill_name": "veda-vs-media", "evals": [ { "id": 1, "prompt": "Udělej slajdy o studii, že ranní káva prodlužuje život", "expected_output": "PPTX se strukturou OTÁZKA → DŮKAZ → SHRNUTÍ", "assertions": [ { "name": "má slide s titulkem studie", "type": "contains" }, { "name": "rozlišuje korelaci od kauzality", "type": "contains" }, { "name": "soubor .pptx existuje", "type": "file_exists" }, { "name": "více než 5 slajdů", "type": "slide_count_gte", "value": 5 } ] } ] }
Kvantitativní vyhodnocení

Benchmark — co se měří

Porovnání: s skillem vs. bez skillu — kvalita, čas, tokeny

Každý test case se spustí dvakrát paralelně: jednou s skillem, jednou bez skillu (baseline). Výsledky se agregují do přehledné tabulky.

Test case S skillem Pass rate Bez skillu Pass rate Δ tokeny Δ čas
Káva a dlouhověkost
PPTX, bias, shrnutí
✅ .pptx existuje
✅ >5 slajdů
✅ korelace ≠ kauzalita
✅ Tufte styl
4/4
100 %
✅ .pptx existuje
⚠️ jen 3 slajdy
❌ chybí bias analýza
❌ obecný styl
2/4
50 % 		−18 % −22 %
Melatonin & srdce
AHA 2025, RCT vs. observační
✅ identifikuje typ studie
✅ abs. vs. rel. riziko
✅ deep research prompt
3/3
100 %
✅ identifikuje typ studie
❌ nezmíní absolutní riziko
❌ žádný prompt
1/3
33 % 		−12 % −15 %
Červené víno a srdce
J-křivka, sick quitter bias
✅ J-křivka vysvětlena
✅ sick quitter bias
⚠️ graf mohl být lepší
2.5/3
83 %
❌ J-křivka neobjasněna
❌ bias vůbec nezmíněn
✅ aspoň graf
1/3
33 % 		−8 % −19 %
94 %
průměrný pass rate
s skillem
39 %
průměrný pass rate
bez skillu
−17 %
průměrná úspora
tokenů
−19 %
průměrná úspora
času
Kvalitativní review

Eval Viewer

Interaktivní prohlížeč výsledků — uživatel projde každý test case a napíše feedback

Po spuštění testů skill-creator vygeneruje statické HTML s výsledky. Uživatel klikne, projde testy, napíše co se mu líbí / nelíbí. Pak odešle a Claude to přečte a skill vylepší.

Eval Viewer — veda-vs-media · Iterace 1 · Test 1 / 3
📋 Výstupy
📊 Benchmark
Prompt
"Udělej mi slajdy o studii, že ranní káva prodlužuje život — chci ukázat jak média manipulují."
Výstup s skillem ✅
📎 kava-longevity.pptx — 8 slajdů
✅ Slide 1: Clickbait titulek "Káva = nesmrtelnost?"
✅ Slide 4: Studie — observační, N=500k, HR 0.87
✅ Slide 5: Absolutní riziko 0.3% vs. relativní −13%
✅ Slide 7: Confounders — zdraví lidé pijí víc kávy
✅ Slide 8: Deep research prompt, Feynman citát
Formální hodnocení
✅ .pptx soubor existuje
✅ více než 5 slajdů (8)
✅ obsahuje "korelace ≠ kauzalita"
✅ Tufte styl (tmavý title, cream content)
Výstup bez skillu ❌ (baseline)
📎 prezentace.pptx — 3 slajdy
❌ Slide 1: "Studie o kávě"
⚠️ Slide 2: Výsledky studie (bez kontextu)
❌ Slide 3: "Závěr: Pijte kávu"

Chybí: bias analýza, absolutní rizika, deep research prompt, Tufte styl
Tvůj feedback (klikni a napiš)
"Slajd s deep research promptem je super! Ale na slide 4 by mohla být větší čísla — absolutní riziko je klíčové. Přidej prosím větší vizuál podobný tomu 478% u melatoninu."
← Předchozí   Další →
Vaše skills

Skills nainstalované v tomto projektu

Každý skill = jiný typ expertízy dostupný na jedno zavolání

📊 pptx
Profesionální prezentace v PptxGenJS. Tufte styl, animace, grafy. Použito pro melatonin slajdy.
PPTXSlajdyGrafy
📄 docx
Word dokumenty s formátováním, TOC, hlavičkami, zápatím. Profesionální výstupy.
WordDokument.docx
🎵 suno-v5-music
Generování hudby. 30+ uměleckých profilů — od Nirvany po Mozarta. Optimalizované tagy pro Suno V5.
HudbaSunoAI generace
🎬 videoklip-generator
Storyboardy pro videoklipy. 50+ vizuálních stylů — Pixar, da Vinci, Simpsons…
VideoMidjourneyStoryboard
🎸 ceske-pisne
Texty českých písní ve stylu Kabátu, Nohavici, Krylu, Tří sester. Teorie versologie.
TextyČeskéKabát
⚗️ skill-creator
Vytváří, testuje a optimalizuje nové skills. Benchmarky, eval viewer, description optimizer.
MetaBenchmarkIterace
Bonus: Description Optimizer
Skill creator umí automaticky optimalizovat description pole v SKILL.md — generuje 20 testovacích promptů (triggering / non-triggering), pustí optimalizační smyčku přes Claude, a najde popis s nejvyšší přesností spouštění na held-out test setu.
Výsledek: skill se spouští přesně kdy má a neotravuje kdy nemá.
# Spuštění description optimizeru python -m scripts.run_loop \ --eval-set evals/trigger-eval.json \ --skill-path skills/veda-vs-media \ --model claude-sonnet-4-6 \ --max-iterations 5 # Výsledek: best_description s pass rate na test setu # Iterace 1: train 70%, test 65% # Iterace 3: train 88%, test 85% ← vybráno # Iterace 5: train 95%, test 78% ← overfit, zamítnuto

„To složité na programování nikdy nebyla syntaxe. Je to způsob myšlení." — Lesk a bída Vibe codingu