Blog

Claude Code Skills v roce 2026: jak si vytvořit vlastní knihovnu skills

Markdown

Jak vytvářet Claude Code Skills: struktura SKILL.md, vzorec pro popis, 5 hotových kolekcí od Anthropic a Matta Pococka a čemu se vyhnout. Krok za krokem za 30 minut.

Přečíst celý článek

Hlavní poznatky

Claude Code Skills jsou složky obsahující soubor SKILL.md, který Claude načítá do kontextu jen tehdy, když je potřeba. CLAUDE.md zůstává v paměti neustále a spotřebovává rozpočet tokenů, zatímco skill se načte po vyvolání spouštěčem — a v jednom projektu může snadno současně existovat desítky skills. Nejdůležitější částí skillu je jeho popis: podle něj Claude rozhoduje, zda skill aktivovat. V tomto článku vysvětluji strukturu SKILL.md, vzorec pro popis, hotové kolekce a jak si za 30 minut vytvořit svůj první skill.

Dokumentace Ailoot: API, klíče a nastavení.

Co je skill v Claude Code a proč to není jen „větší prompt“?

Hlavní poznatky

Skill je adresář obsahující soubor SKILL.md, který popisuje, kdy a jak použít konkrétní metodiku. Anthropic přirovnává skill k instrukcím pro nového zaměstnance: každý den mu neříkáte každý krok; dáte mu postup a on ho ve správných situacích sám použije. Hlavní rozdíl oproti CLAUDE.md spočívá v tom, že skill se načítá do kontextu pouze podle potřeby, takže v projektu mohou být desítky skills, aniž by se vyčerpal rozpočet tokenů.

Claude Code Skills jsou nativní funkcí Claude Code, kterou Anthropic spustil v říjnu 2025 pro tarify Pro/Max/Team/Enterprise. Později otevřel specifikaci Agent Skills jako standard, který funguje i mimo Claude. V kódu jde jednoduše o složku:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Každá složka představuje jeden skill. Soubor SKILL.md je Markdown s YAML frontmatterem nahoře a běžnými instrukcemi pod ním. Když uživatel požádá „pojďme nasadit do produkce“, Claude uvidí popis skillu deploy-to-prod, rozpozná spouštěč „nasadit do produkce“, načte tělo SKILL.md do kontextu a provede uvedené kroky.

Tři úrovně postupného načítání

Anthropic vytvořil skills s postupným načítáním: data se načítají ve vrstvách podle potřeby. Tým v blogu Anthropic Engineering popisuje tento přístup jako „základní princip návrhu, díky kterému jsou Agent Skills flexibilní a škálovatelné“ (Anthropic Engineering).

Tři úrovně načítání:

  1. Metadata (vždy) — při zahájení relace Claude vidí pouze name a description každého skillu. Rozpočet: přibližně 100 tokenů na skill.
  2. Instrukce (po vyvolání) — když uživatel řekne něco souvisejícího, Claude načte tělo SKILL.md. Rozpočet: méně než 5000 tokenů.
  3. Zdroje (na vyžádání) — přibalené soubory (příklady, šablony, datové sady) se načtou, až když je model sám vyhledá. Rozpočet: neomezený.

Dříve musel CLAUDE.md obsahovat vše, co si měla AI „pamatovat“ — a projekt s 50 pravidly rychle narazil na limit kontextu. Díky skills mohou v jednom projektu snadno koexistovat desítky skillů, protože do počátečního kontextu se dostanou pouze jejich popisy.

Kde skills uchovávat: čtyři úrovně

ÚroveňCestaPlatí pro
EnterpriseNastavení spravované organizacíVšechny uživatele firmy
Osobní~/.claude/skills/<name>/SKILL.mdVšechny vaše projekty
Projekt.claude/skills/<name>/SKILL.mdPouze tento projekt
Plugin<plugin>/skills/<name>/SKILL.mdTam, kde je plugin povolen

Priorita: enterprise přepisuje osobní nastavení, osobní nastavení přepisuje projektové. Pluginy používají jmenný prostor plugin-name:skill-name a nekolidují s ostatními. Je to praktické: obecné profesní skills umístěte do ~/.claude/skills/ a ty specifické pro projekt do .claude/skills/ v repozitáři.

Co obsahuje SKILL.md dovednosti Claude Code?

Hlavní poznatky

SKILL.md je soubor Markdown s YAML frontmatterem nahoře a textem instrukcí pod ním. Obsahuje alespoň dvě pole: name (maximálně 64 znaků) a description (maximálně 1024 znaků). Úplné schéma zahrnuje allowed-tools, disable-model-invocation, paths, context: fork, agent a hooks. Anthropic doporučuje udržet tělo instrukcí do 500 řádků a vše ostatní umístit do blízkých referenčních souborů.

Tady je minimální příklad — dvacet řádků a skill je připraven:

---
name: weekly-content-plan
description: Připravuje týdenní plán příspěvků pro kanál Telegram. Spouštěče — „vytvoř plán příspěvků“, „co mám tento týden zveřejnit“, „sedmidenní plán pro kanál“. Neaktivuj, pokud se požadavek týká webu nebo e-mailového newsletteru.
---

# Týdenní plán obsahu

## Kroky

1. Přečti `knowledge/audience.md` — komu píšeme
2. Přečti `knowledge/tone-of-voice.md` — jak píšeme
3. Přečti posledních 10 příspěvků v kanálu — čemu už jsme se věnovali
4. Vymysli 7 témat na týden: 3 prodejní, 2 odborná, 2 osobní
5. Ke každému uveď jeden úvodní řádek a tři odrážky o příspěvku
6. Výstup uveď v tabulce: den v týdnu | typ | úvodní řádek | plán

To stačí. Když uživatel napíše „pojďme naplánovat příspěvky na tento týden“, Claude v popisu rozpozná spouštěč, načte SKILL.md, přečte pojmenované soubory a vytvoří tabulku.

Limity, které je dobré znát

Oficiální dokumentace Claude API stanovuje přísné limity:

  • name: maximálně 64 znaků, pouze malá písmena, číslice a pomlčky, bez XML tagů. anthropic a claude jsou rezervované názvy.
  • description: v API maximálně 1024 znaků; je povinný a nesmí obsahovat XML tagy.
  • Rozpočet výpisu: v Claude Code zaberou popisy všech skills dohromady přibližně 1 % kontextového okna. Pokud je skills mnoho, popisy se zkrátí — a mohou zmizet klíčová slova, která Claude potřebuje k nalezení shody.
  • Tělo SKILL.md: Anthropic doporučuje udržet tělo do 500 řádků. Vše, co je delší, přesuňte do souborů references/, scripts/ a examples/ a načítejte je prostřednictvím instrukcí.

Po zhuštění kontextu (/compact) si Claude ponechá prvních 5000 tokenů každého dříve vyvolaného skillu; celkový rozpočet pro všechny znovu připojené skills je 25 000 tokenů. Pokud se skill nevejde, jeho chování se „zapomene“.

Úplné schéma frontmatteru

Minimálně použijte name a description. Produkční skills používají i další pole:

PoleÚčelPříklad
nameNázev skillu; pokud chybí, použije se název složkydeploy-to-prod
descriptionSpouštěč automatického vyvoláníViz vzorec níže
when_to_useDalší fráze spouštějící skill["deploy", "pojďme to nasadit"]
allowed-toolsNástroje použitelné bez žádosti o svolení["Read", "Bash(npm run build)"]
disable-model-invocationtrue — skill může vyvolat pouze uživatelPro nebezpečné operace
user-invocablefalse — skill může vyvolat pouze ClaudePro znalosti na pozadí
pathsVzory glob určující, kde je skill aktivní["src/**/*.ts"]
context: forkSpustí se v izolovaném subagentuKdyž je kontext rozsáhlý
agentTyp subagenta ke spuštěníExplore, Plan, general-purpose
effortÚroveň uvažovánílow, medium, high, xhigh, max
modelModel přiřazený skilluclaude-opus-4-7
hooksHooky v životním cyklu skilluViz část o hookách

Pole disable-model-invocation: true je nezbytné pro vše, co se nesmí spustit automaticky. Například skill deploy-to-prod s tímto příznakem lze vyvolat pouze tehdy, když uživatel výslovně zadá /deploy-to-prod. Bez něj by Claude mohl nasadit aplikaci, protože „kód vypadá připraveně“.

Proč popis představuje 90 % práce a jak ho napsat?

Hlavní poznatky

Popis je jediné pole, které Claude vidí na začátku relace. Pokud je napsaný špatně, skill nebude fungovat, i kdyby jeho tělo instrukcí bylo dokonalé. Dobrý popis má tři části: co dělá + fráze spouštějící skill v uvozovkách + kdy ho NEpoužívat. Anthropic ve vlastním skill-creator doporučuje psát popisy „trochu naléhavě“ — Claude má sklon spouštět skills příliš zřídka.

Nejčastější chyba vibe-coderů je napsat popis jako „Pomocník pro X“. Skill fyzicky existuje ve své složce, ale Claude ho nevyvolá.

Špatný popis

description: Vytváří dashboardy.

Co Claude nedokáže určit: týká se požadavek „ukaž mi tržby za týden“ dashboardu? Týká se „grafu příjmů“ dashboardu, nebo jen grafu obecně? Není „měsíční report“ určitě něco jiného než dashboard?

Vlastní skill-creator od Anthropic doporučení formuluje přímo:

Claude má v současnosti sklon skills „spouštět příliš zřídka“ — nepoužívat je, ani když by byly užitečné. Proto popisy skillů formulujte trochu „naléhavěji“.

— Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md

Vzorec pro dobrý popis

Tři části:

  1. Co dělá — jedna věta o výsledku, ne o postupu. Ne „generuje SQL“, ale „exportuje tržby do tabulky pro kanál Telegram“.
  2. Kdy ho spustit — 3–5 citovaných frází, které uživatelé skutečně říkají. Nehádejte; podívejte se do historie chatu a podpory.
  3. Kdy ho NESPOUŠTĚT — 1–2 fráze popisující podobné úlohy, na které skill nemá reagovat. Bez této části budou dva podobné skills stále kolidovat.

Příklad silného popisu z mého projektu (zjednodušený a anonymizovaný):

description: |
  Píše a publikuje SEO průvodce na blogu v souladu s redakčními zásadami.
  Spouštěče: „napiš průvodce o X“, „pojďme vytvořit nový pilíř“,
  „článek na blog o Y“, „vytvoř blogový průvodce o Z“.
  Neaktivuj, pokud se požadavek týká e-mailového newsletteru,
  příspěvku na Telegram nebo interní týmové instrukce —
  pro ně jsou určeny jiné skills.

Co tu funguje:

  • Sloveso „píše a publikuje“ místo „pomáhá s“ určuje konkrétní výsledek.
  • Čtyři fráze v uvozovkách pokrývají různé formulace.
  • Je uveden i anglický spouštěč — skill bude fungovat i tehdy, když uživatel přepne na jazyk týmu.
  • Samostatná část „neaktivuj, pokud“ předchází kolizím se skills pro e-maily a příspěvky.

Jak otestovat popis

Anthropic ve svém skill-creator připravil metodiku trigger-evals: 20 promptů pro ověření, zda se skill aktivuje. Deset by ho aktivovat mělo a deset ne (včetně hraničních případů, kdy je formulace podobná, ale úloha odlišná).

V řeči vibe-coderů to znamená: po napsání popisu otevřete prázdný chat a vyzkoušejte 5 frází, které skutečně používáte, a 3 podobné fráze s jiným významem. Pokud se skill neaktivuje, když má, nebo se aktivuje, když nemá, upravte popis. Teprve pak napište tělo instrukcí.

Kterých 5 skills bych si nainstaloval jako první?

Hlavní poznatky

Nejrychlejší strategií pro podnikatele je začít s hotovými kolekcemi a přizpůsobit si je. Anthropic a Vercel zveřejnili veřejné kolekce, které lze nainstalovat jediným příkazem a které pokrývají běžné úlohy, jako jsou dokumenty a návrh. Květnu 2026 měl oficiální repozitář anthropics/skills přibližně 138 000 stars.

Strávit první dva týdny psaním vlastních skills je špatná strategie. Začněte instalací hotových a podívejte se, jak jsou vytvořené; potom stejným způsobem přidávejte vlastní. Je levnější vzít osvědčené kolekce od ostatních a upravit si je než vytvářet vše od nuly. Tady je pět kolekcí, se kterými bych začal:

1. anthropics/skills — oficiální kolekce se skill-creator

Repozitář: github.com/anthropics/skills. 138 000 stars na GitHubu. Obsahuje oficiální skills týmu Anthropic: skill-creator (meta-skill, který píše další skills), claude-api (pomáhá vytvářet integrace API) a hotové skills pro dokumenty PowerPoint, Excel, Word a PDF.

Instalace v Claude Code:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Hlavní přínos představuje skill-creator. Na základě vašeho popisu vytvoří SKILL.md, pak spustí 20 trigger-evals a upravuje popis, dokud se skill nezačne aktivovat ve správných situacích. V podstatě jde o „skill pro vytváření skills“.

2. mattpocock/skills — virální kolekce experta na TypeScript

Obsahuje 12 aktivních skills, například:

  • grill-me — klade otázky podle rozhodovacího stromu, dokud se nevyjasní nejistoty v úloze. Hlavní problém vibe-coderů — „Nevím, co chci“ — řeší hned v první iteraci.
  • caveman — převádí komunikaci modelu do telegrafického stylu.
  • diagnose — ladění v cyklu reprodukce — minimalizace — hypotéza — instrumentace — oprava — regresní test.
  • tdd — vynucuje cyklus red-green-refactor: nejprve neúspěšný test, potom minimální oprava a nakonec refaktoring.
  • to-issues — převádí plán na vertikálně rozdělené úkoly GitHub Issues (full-stackové, samostatně nasaditelné).

Instalace:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills — kolekce pro marketéry

Pokud vedete online programy, pracujete jako freelance marketér nebo provozujete agenturu, nemusíte šest měsíců psát vlastní skills. Polovina úloh už je připravená.

4. vercel-labs/agent-skills — design bez typického vzhledu AI

Repozitář: github.com/vercel-labs/agent-skills. Hlavním skillem je web-design-guidelines. Kontroluje kód uživatelského rozhraní podle více než 100 pravidel přístupnosti, výkonu a použitelnosti.

Vedle něj stojí frontend-design od Anthropic, který má přes 110 000 instalací týdně. Přiměje AI zvolit styl ještě před zahájením psaní kódu. Bez něj má každá stránka vytvořená Claudem font Inter, fialový gradient a mřížku karet. Výsledek je pro všechny stejný.

5. obra/superpowers — workflow s více agenty

Celkově, pokud nainstalujete první tři kolekce z tohoto seznamu — anthropics/skills, mattpocock/skills a coreyhaines31/marketingskills — bude mít váš Claude Code už během prvního měsíce desítky hotových skills pokrývajících většinu podnikatelských úloh.

Chcete nejen instalovat hotové skills, ale také vytvořit nastavení, díky kterému bude Claude skutečně vaším asistentem? Skills jsou jedním ze tří pilířů metodiky. Funkční nastavení má tři části: klon AI (Skills jako zabalené odborné znalosti) + Druhý mozek (znalostní struktura poskytující kontext) + kontextové inženýrství (jak Claude vnímá projekt jako celek). Toto nastavení mění Claude z asistenta, který hádá, na nástroj, který uvažuje podle vaší logiky.

Které opakující se úlohy byste měli proměnit ve skill?

Hlavní poznatky

Pravidlo je jednoduché: každá činnost, kterou děláte více než dvakrát týdně a která má přibližně stejný postup, může být skillem. Ne složitá „jednou ročně připravovaná zpráva pro auditora“, ale běžná práce: plán obsahu kanálu, kontrola dokladů klientů nebo uvítací e-mail pro nového účastníka. Skill změní jednorázovou práci v aktivum, které funguje bez vás.

Při práci s klienty a na projektech jiných lidí jsem tento vzorec viděl už mnohokrát. Někdo má „tu věc, kterou pokaždé dělá od nuly“. Každé pondělí píše stejný typ zprávy. Pokaždé, když získá nového klienta, projde stejným postupem. Každá publikace vychází ze stejné šablony. A pokaždé to zabere 30–90 minut, protože si musí znovu vybavit kroky, otevřít správné soubory a zformulovat prompt pro Claude.

Řešením je jednou tento postup zabalit do skillu. Potom stačí vyslovit jednu frázi a Claude načte metodiku, přečte potřebné zdroje a vytvoří výsledek. Tři příklady z různých oborů:

Příklad 1. Freelance marketér — skill weekly-content-plan

Co dělá ručně: každé pondělí připravuje týdenní příspěvky na Telegram pro tři klienty. Otevře příručku klientova hlasu značky, zkontroluje nedávné příspěvky, vymyslí témata podle produktového kalendáře a sestaví tabulku s úvodními řádky a odrážkami.

Ve formě skillu jde o instrukce v pěti krocích: přečíst soubor s tónem klienta, přečíst produktový kalendář, zkontrolovat posledních 10 příspěvků kvůli opakování, vymyslet sedm témat rozdělených podle typu (prodejní, odborná, osobní) a vytvořit tabulku.

Příkaz „naplánuj příspěvky na tento týden pro klienta X“ změní hodinu příprav na tři minuty čekání. Marketér zkontroluje výsledek, provede cílené úpravy a pošle ho klientovi.

Příklad 2. Externí účetní — skill monthly-receipts-close (příklad autora)

Co dělá ručně: každý měsíc pro každého klienta v portfoliu exportuje bankovní výpis, porovná ho s platbami v účetním systému, označí nezařazené platby, připraví předběžný výkaz příjmů a porovná strukturu příjmů s předchozím měsícem.

Skill tvoří instrukce v šesti krocích a několik shell skriptů ve složce scripts/ pro parsování bankovních výpisů. Spouštěč „uzavři květen pro klienta X“ přiměje Claude vytvořit zprávu s označenými nesrovnalostmi za 4–5 minut.

Příklad 3. Tvůrce online programu — skill welcome-letter-new-participant

Co dělá ručně: nový účastník zaplatil a je třeba mu napsat uvítací e-mail. Dobré uvítání je osobní: zohledňuje kanál, odkud přišel, zakoupený produkt, kohortu i materiály, které mu máte poslat. Šablona „ahoj, jsme rádi“ to nezvládne.

Skill instruuje Claude, aby přečetl knowledge/audience.md (kdo jsou tito lidé), knowledge/products/<product>.md (co dostanou) a poslední tři uvítací e-maily (aby se neopakoval), a pak napsal e-mail podle této struktury: úvodní věta — podrobnosti o produktu — první tři kroky — závěr.

Mnohem rychleji než ručně. Kvalita je konzistentnější, protože Claude nezapomene zkontrolovat tři zdroje, zatímco člověk ve spěchu jeden z nich vynechá.

Co NEproměňovat ve skill

  • Jednorázové úlohy. Pokud to děláte jednou ročně při podání daňového přiznání, jednoduše to popište Claudovi v chatu. Skill se vyplatí po 3+ opakováních.
  • Příliš obecné úlohy. „Pomoz mi s marketingem“ není skill; je to celý marketing. Skillem je „týdenní plán obsahu“ — konkrétní činnost s konkrétním výsledkem.
  • Úlohy bez opakovatelného postupu. Pokud se proces pokaždé liší, nejde o skill, ale o jednorázovou práci.

Jak Skill Creator píše skills za vás?

Hlavní poznatky

Skill Creator je meta-skill od Anthropic, spuštěný příkazem /skill-creator. Provede vás šesti kroky: návrh, testování, vyhodnocení, iterace, optimalizace a zabalení. Výsledkem je připravený SKILL.md otestovaný na 20 trigger-evals (10 případů, kdy se má aktivovat, a 10, kdy se aktivovat nemá). Pro neprogramátora je to nejrychlejší způsob, jak napsat první funkční skill — bez studování YAML nebo dohadování s Claudem.

Háček je v tom, že napoprvé se dobrý skill píše obtížně. Popis často vyjde příliš úzký nebo široký, chybějí v něm fráze, které uživatelé skutečně používají, nebo koliduje se sousedním skillem. Anthropic to řešil vydáním skill-creator, meta-skilu, který vytváří další skills.

Po instalaci anthropics/skills řekněte Claudovi /skill-creator (nebo jednoduše „pojďme vytvořit skill pro týdenní zprávu“) a postupujte podle šestifázového workflow:

  1. Návrh — skill-creator se zeptá, co má skill dělat, které fráze ho mají spouštět, které zdroje má číst a jaké kroky má následovat. Výsledkem je první verze SKILL.md.
  2. Testování — skill-creator vytvoří 20 testovacích promptů: 10, které mají skill spustit, a 10, které vypadají jako spouštěče, ale nemají ho spustit (blízké případy).
  3. Vyhodnocení — každý prompt spustí v novém chatu a zkontroluje, zda se skill aktivoval. Pokud se aktivuje, když nemá, nebo se neaktivuje, když má, označí výsledek.
  4. Iterace — na základě neúspěchů přepíše popis a testy znovu spustí.
  5. Optimalizace — závěrečné doladění: kontrola překročení limitu 1024 znaků a konfliktů s existujícími projektovými skills.
  6. Zabalení — zabalí konečný SKILL.md a referenční soubory do správné struktury.

V praxi to vypadá takto: 15–20 minut si povídáte s Claudem, odpovíte na 7–8 upřesňujících otázek a na konci dostanete hotový, otestovaný skill, který se aktivuje na správné spouštěče.

Další výhodou je, že skill-creator ukazuje příkladný styl psaní SKILL.md. Můžete otevřít jeho vlastní soubor a podívat se na formát, tón i strukturu kroků. Je to případ, kdy nástroj předvádí sám sebe — přečtete si ho a naučíte se psát vlastní.

Skills, CLAUDE.md, subagenti, MCP, Hooks: co použít?

Hlavní poznatky

Claude Code nabízí pět odlišných stavebních prvků pro rozšíření chování; nejsou zaměnitelné. CLAUDE.md obsahuje trvalé znalosti o projektu. Skills jsou opakovatelné workflow aktivované spouštěči. Subagenti pracují paralelně v odděleném kontextu. MCP propojuje externí systémy (API, databáze). Hooks automaticky reagují na události. Nejčastější chybou vibe-coderů je nacpat vše do CLAUDE.md nebo se pokoušet vytvořit skill pomocí hooku.

Nejběžnějším problémem v projektech, které jsem kontroloval, je CLAUDE.md obsahující dohromady pravidla projektu, podrobné pokyny k publikování, šablonu pro commit a popis databáze. Přetěžuje to kontext a v praxi to také selhává: Claude neprovede instrukci „když uživatel požádá o publikování“, protože model považuje celý CLAUDE.md za obecný kontext bez výslovných spouštěčů.

Řešením je přiřadit každou věc správnému stavebnímu prvku:

CoKdy použítPříklad
CLAUDE.mdZnalosti potřebné VŽDY„Projekt má pevně daný jazyk“, „v textu nepoužívej dlouhé pomlčky“, „název značky se píše s ‚o‘“
SkillsOpakovatelný postup aktivovaný spouštěčem„Nasadit do produkce“, „týdenní plán příspěvků“, „uzavřít klientovo účetnictví za měsíc“
SubagentsParalelní práce nebo izolace rozsáhlého kontextu„Bezpečnostní audit, zatímco plánuji novou funkci“, „zkontrolovat kódovou základnu v oddělené relaci“
MCPPropojení s externím systémem„Získat data z CRM“, „načíst úkoly ze sledovacího systému“, „zkontrolovat web v prohlížeči“
HooksAutomatická reakce na událost„Spustit kontrolu po Edit“, „zablokovat nebezpečné příkazy“, „po dokončení poslat oznámení na Telegram“

V recenzi stavebních prvků Claude Code od Alexe Opa („Understanding Claude Code's Full Stack“) se vše zjednoduší na tuto logiku: Skills a MCP pokrývají většinu workflow; Hooks automatizují běžné úkoly — kontroly kódu, testy a ochranná pravidla. Subagenti jsou potřeba, když je kontext rozsáhlý. Nejčastější chybou je vytvářet subagenta tam, kde by se měl použít skill.

Rozhodovací strom

Když si pomyslíte „potřebuji, aby Claude udělal X“:

  1. Jsou tyto znalosti potřeba neustále? Například „projekt má pevně daný jazyk“ nebo „nepoužíváme dlouhé pomlčky“. → Vložte je do CLAUDE.md.
  2. Jde o postup spouštěný určitou situací, který nyní děláte ručně? Například „každé pondělí píšu zprávu“. → Vytvořte skill.
  3. Potřebujete přístup k externímu systému? Například k API Stripe nebo CRM. → Připojte MCP server.
  4. Má Claude Code automaticky reagovat na událost? Například spustit linter po každém Edit. → Napište hook.
  5. Je úloha rozsáhlá, spotřebuje celý kontext a potřebujete souběžně dělat něco jiného? → Spusťte subagenta.

90 % úloh podnikatele-vibe-codera spadá do kategorií 1–3. Hooks a subagenti jsou pokročilejší nástroje pro chvíli, kdy už jste přešli od „jedné úlohy najednou“.

Příkazy Slash Commands a skills jsou totéž

V Claude Code došlo k důležité změně: starý systém slash commands (.claude/commands/) a skills se fakticky sloučily. Soubor .claude/commands/deploy.md i .claude/skills/deploy/SKILL.md vytvoří příkaz /deploy. Pokud se názvy shodují, přednost má skill. Pokud stále používáte starý formát slash commands, přejděte na skills; jejich syntaxe je přehlednější a nabízejí více možností.

7 chyb, kvůli kterým skill nefunguje

Hlavní poznatky

Nejčastější problémy se skills nejsou chybami Claude, ale chybami v samotném skillu. Popis bez spouštěčů, přetížený SKILL.md o 2 000 řádcích, dva podobné skills, které si odporují, nebo pokus stáhnout „všechno z marketplace“. Každá z těchto chyb narušuje aktivaci skillu nebo jeho fungování.

1. Popis bez spouštěčů: skill se neaktivuje

Příznak: napsali jste skill, zkontrolovali strukturu a vše je platné, ale Claude ho na žádost uživatele nevyvolá. Příčina je téměř vždy stejná: popis jako „Pomocník pro psaní obsahu“. Claude neví, na které fráze má reagovat. Oprava: vložte do popisu přímo 3–5 skutečných uživatelských frází v uvozovkách.

2. SKILL.md delší než 500 řádků: pozornost se rozptyluje

Anthropic výslovně doporučuje udržet tělo souboru do 500 řádků. Pokud mají vaše instrukce 2 000 řádků, Claude ztrácí soustředění, provádí jen část kroků a plete si jejich pořadí. Oprava: přesuňte rozsáhlé části do blízkých souborů — examples/, references/, scripts/ — a odkažte na ně v SKILL.md.

3. Jeden skill pro „všechno kolem obsahu“ místo tří malých

Lákavé nastavení: jeden velký skill content, v němž jsou příspěvky na Telegram, landing pages i e-maily. Nefunguje to. Skill se aktivuje u nesprávných požadavků, směšuje metodiky a vytváří zprůměrovaný výsledek. Oprava: jeden skill = jedna opakovatelná činnost. Pokud máte tři rutiny kolem „obsahu“, vytvořte tři skills: telegram-post, landing-section, email-broadcast.

4. Skill bez části „Kdy ho NEpoužívat“: kolize

Příznak: v projektu jsou dva podobné skills a Claude vyvolá ten nesprávný. Jeden skill se například týká e-mailového newsletteru a druhý konkrétně uvítacích e-mailů pro účastníky programu. Bez výslovného upozornění „neaktivuj, pokud jde o obecný mailing list“ se skill pro uvítací e-maily spustí při jakékoli zmínce o „e-mailu“. Oprava: v popisu výslovně uveďte negativní případy.

5. 50 skills v projektu: popisy se zkrátí

Z dokumentace Claude Code:

Názvy skills jsou vždy zahrnuté, ale pokud je skills mnoho, jejich popisy se zkrátí, aby se dodržel limit znaků. Mohou tak zmizet klíčová slova, která Claude používá k nalezení shody s vaším požadavkem. Rozpočet — 1 % kontextového okna modelu.

— Claude Code Documentation, https://code.claude.com/docs/en/skills

Pokud jste z marketplace stáhli 50 kolekcí skills, některé popisy budou zkrácené. Klíčová slova, na která jste spoléhali, mohou zmizet. Oprava: v aktivním projektu ponechte 10–15 nejužitečnějších skills. Zbytek ponechte v neaktivním archivu mimo všechny prohledávané adresáře skillů, například v oddělené složce skill-archive/ vlastních materiálů. Do projektového či osobního rozsahu instalujte jen potřebné skilly. ~/.claude/skills/ je nainstalovaná osobní knihovna viditelná napříč projekty, takže přesun sem skilly z vyhledávání nevyřadí.

6. Skills z neověřených zdrojů: bezpečnostní riziko

Anthropic na to upozorňuje v oficiální dokumentaci:

Používejte pouze skills z důvěryhodných zdrojů: takové, které jste sami vytvořili nebo získali od Anthropic. Škodlivý skill může způsobit, že Claude bude volat nástroje nebo spouštět kód způsobem odlišným od deklarovaného účelu skillu.

— Anthropic Agent Skills Overview, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

Náhodný repozitář GitHubu může obsahovat skill, který při prvním vyvolání prozradí vaše API klíče. Oprava: před instalací otevřete SKILL.md a sami si ho přečtěte. V důležitých projektech nespouštějte skills od neznámých autorů.

7. Skill bez složky se znalostmi vytváří „průměrný ChatGPT“

Nejnenápadnější a nejčastější antipattern. Skill je metodika, ale bez kontextu samotná metodika nic neznamená. Pokud napíšete skill „vytvoř uvítací e-mail“, ale projekt neobsahuje soubor popisující publikum ani soubor s hlasem značky, Claude napíše průměrný e-mail ve stylu ChatGPT, který se nebude lišit od e-mailů ostatních.

Skill funguje nejlépe, když už máte vytvořený projektový Druhý mozek podle zásad v průvodci souborem CLAUDE.md. Nejprve vybudujte strukturu znalostí a potom vytvořte skills, které z ní čerpají. Pokud pořadí obrátíte, dostanete rutinní, průměrnou kvalitu místo personalizované práce ve vlastním stylu.

Jak si za 30 minut vytvořit první skill

Hlavní poznatky

Postup pro vytvoření prvního funkčního skillu: vyberte jednu opakovatelnou činnost, sepište kroky, vytvořte strukturu složek, napište popis podle vzorce, otestujte ho na 5–8 promptech a upravujte, dokud se skill neaktivuje ve správných situacích. Realistický čas pro první skill je 30–40 minut. Každý další zabere 10–15 minut, protože formát už budete znát.

Tady je konkrétní plán, který jsem použil při vytváření prvních skills ve svých projektech:

Krok 1. Vyberte jednu opakovatelnou činnost

Otevřete kalendář za poslední měsíc. Najděte úlohu, kterou jste dělali alespoň 4–5krát a která pokaždé trvala 30–60 minut. Ne obecný „marketing“, ale něco konkrétního: „pondělní zpráva o prodeji“, „zaškolení nového klienta“ nebo „aktualizace ceníku pro akci“.

Čím užší je formulace, tím jednodušší je skill a přesnější spouštěč.

Krok 2. Sepište postup vlastními slovy

Do samostatného souboru nebo do chatu s Claudem (nejde o skill, ale o návrh) sepište kroky, které dodržujete:

1. Otevři databázi klientů
2. Filtruj podle stavu "čeká na uvítací e-mail"
3. Zkontroluj, ze kterého kanálu klient přišel
4. Ve složce "templates" najdi šablonu e-mailu pro tento kanál
5. Doplň jméno, produkt a datum zahájení
6. Odešli

Ještě to není skill, jsou to jen poznámky. Bez nich byste se při psaní SKILL.md hned od začátku zamotali.

Krok 3. Vytvořte strukturu složek

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Nebo skill umístěte do ~/.claude/skills/, pokud ho chcete používat ve všech svých projektech.

Krok 4. Napište SKILL.md podle šablony

Základní kostra:

---
name: welcome-email-new-client
description: |
  Připraví uvítací e-mail pro nového klienta s použitím šablony pro kanál, kterým klient přišel.
  Spouštěče: „napiš uvítací e-mail pro nového klienta X“,
  „začni spolupráci s novým účastníkem Y“, „uvítací e-mail pro klienta z kanálu Z“.
  Neaktivuj, pokud se požadavek týká obecného mailing listu
  nebo e-mailové kampaně — pro ně jsou určeny jiné skills.
---

# Uvítací e-mail pro nového klienta

## Kroky

1. Přečti `knowledge/audience/segments.md` — jaké máme segmenty klientů
2. Přečti `knowledge/templates/welcome/` — šablony pro jednotlivé kanály
3. Z kontextu požadavku určete kanál klienta
4. Vlož jméno klienta, název produktu a datum zahájení
5. Zkontroluj délku — nesmí přesáhnout 800 znaků
6. Vypiš konečný text e-mailu ve formátu připraveném ke zkopírování

## Důležité

- Nepoužívej oslovení „milý příteli“ ani „ahoj“ — piš přirozeně
- Jeden odstavec, jedna myšlenka
- Zakonči jednou výzvou k akci, ne dvěma

Krok 5. Otestujte 5–8 promptů

V tomto projektu otevřete prázdný chat s Claude Code. Vyzkoušejte 5 frází, které skutečně používáte, a 3 podobné, které skill spustit nemají:

Měly by spustit skill:

  • „Napiš uvítací e-mail pro nového klienta Ivanova“
  • „Začni spolupráci s novým účastníkem, který si koupil program X“
  • „Uvítací e-mail pro klienta z Instagramu“

Neměly by spustit skill:

  • „Pošli akční e-mail celému seznamu“
  • „E-mailová kampaň k novoročním svátkům“
  • „Napiš následný e-mail klientovi, který ještě nezaplatil“

U každé fráze zkontrolujte, zda se skill aktivoval. Pokud se aktivuje v nesprávných případech, zúžte popis. Pokud se neaktivuje tam, kde má, rozšiřte fráze spouštějící skill.

Krok 6. Upravujte popis

Po každém neúspěšném testu upravte pouze popis — těla instrukcí se nedotýkejte. Po 2–3 iteracích se skill začne spolehlivě aktivovat. Uložte ho, commitněte a používejte každý den.

Závěrečná rada: nesnažte se, aby byl váš první skill dokonalý. Zprovozněte ho. Vyladění přijde po pátém nebo desátém skillu, až začnete pozorovat vzorce ve svých formulacích a odpovědích Claude.

Vyberte si tento týden jednu opakující se úlohu z kalendáře, vyhraďte si 30 minut a projděte všech šest kroků. Claude pak bude pracovat podle vaší metodiky místo toho, aby hádal.

Funkční nastavení je klon AI + Druhý mozek + kontextové inženýrství. Tři části jediné metodiky.

Pokud potřebujete přístup k modelům AI prostřednictvím Ailoot, podívejte se na Ailoot.

Další podrobnosti

Časté otázky

Vyřadí přesun do ~/.claude/skills/ skill z činnosti?

Ne. Tento adresář je osobní instalační rozsah a zpřístupňuje skill napříč projekty. Nepoužívané balíčky archivujte mimo všechny prohledávané adresáře skillů a instalujte jen aktuálně potřebné.

Jak ověřit správnou aktivaci podle popisu?

Vyzkoušejte pět frází, které mají skill vyvolat, a tři podobné požadavky, které ho vyvolat nemají. Použijte nové chaty, zaznamenejte načtený skill a při vynechaném skutečném požadavku či falešné shodě popis upravte.

Všechny články