Claude Skills návod: vlastní dovednosti agenta, které přestanou opakovat

Pokud používáš Claude Code nebo API déle než pár týdnů, znáš ten pocit: píšeš do promptu znovu a znovu totéž. Jak se u vás píše commit message, jak vypadá struktura reportu, jaké knihovny smí agent sáhnout, jak se formátuje faktura pro klienty. Každá konverzace začíná stejnými pěti odstavci a agent je stejně jednou za čas zapomene.

Přesně na tohle existují Agent Skills. Skill je adresář na disku s jedním povinným souborem SKILL.md, do kterého zabalíš pracovní postup, firemní kontext a kousek kódu. Claude si ho načte jen v momentě, kdy ho potřebuje — a ty přestaneš být zajatcem vlastního copy-paste.

V tomto návodu si jeden takový skill postavíme od nuly, vysvětlíme si, jak funguje progresivní načítání obsahu, a ukážeme si, kde všude se Skills dají provozovat.

Co je skill a v čem se liší od promptu

Skill není prompt. Prompt je instrukce pro jednu konverzaci — platí tady a teď. Skill je souborová struktura, kterou agent objeví na disku a použije, když se hodí. Rozdíl je zásadní ve třech věcech:

1. Načítá se podle potřeby. Prompt spotřebovává kontextové okno vždycky. Skill se načte jen tehdy, když se tvůj požadavek trefí do jeho popisu.
2. Uchovává komplexní obsah. Do promptu nacpeš tak 500 slov a doufáš. Do skillu můžeš zabalit celou dokumentaci interního API, schéma databáze nebo šablony — a tokeny se spotřebují jen ze souborů, které agent skutečně otevře.
3. Může obsahovat spustitelný kód. Vedle instrukcí může skill obsahovat skripty, které agent spustí přes bash. Kód skriptu se do kontextu nedostane — jen jeho výstup. Deterministická operace, žádné generování nazdařhudlu.

Anthropic navíc nabízí čtyři předpřipravené skills pro práci s dokumenty: pptx, xlsx, docx a pdf. Ty fungují na claude.ai a přes API bez jakéhokoli nastavování — pokud něco z toho děláš, máš je už teď k dispozici.

Jak funguje progressive disclosure

Celá architektura stojí na tom, že obsah se načítá ve třech úrovních:

• Úroveň 1 — metadata. Při startu si Claude načte jen name a description z YAML hlavičky SKILL.md. To stojí zhruba 100 tokenů na skill. Klidně jich můžeš mít nainstalovaných dvacet, dokud se nepoužijí, nestojí skoro nic.
• Úroveň 2 — instrukce. Když se tvůj požadavek trefí do popisu skillu, agent spustí cat SKILL.md a načte tělo souboru. Tady je místo pro pracovní postup, best practices, příklady.
• Úroveň 3 — zdroje a kód. SKILL.md může odkazovat na další soubory: REFERENCE.md se schématem databáze, FORMS.md s postupem pro formuláře, skripty v scripts/. Agent si otevře jen to, co aktuálně potřebuje. Skripty spustí a do kontextu jde jen výsledek.

Prakticky to znamená: piš SKILL.md jako onboarding dokument pro nového kolegu. Ne jako prompt. Nový kolegu nezajímá 40 stran referenční dokumentace hned první den — chce vědět, co má dělat, kdy to dělat a kde najde detaily, až je bude potřebovat.

Praktický příklad: skill pro reporty z dat

Pojďme si postavit skill reporty-z-dat, který naučí agenta, jak u tebe ve firmě vypadá týdenní report. Struktura:

reporty-z-dat/
├── SKILL.md
├── METRIKY.md
└── scripts/
    └── validuj_data.py

Krok 1: SKILL.md s hlavičkou

Povinné pole jsou dvě: name a description. A právě description je nejdůležitější část celého skillu — podle ní se agent rozhoduje, jestli ho použije. Musí říct co skill dělá a kdy se má použít:

---
name: reporty-z-dat
description: Generuje [týdenní reporty](/content/jak-automatizovat-tydenni-reporty-pomoci-ai-od-sberu-dat-po-hotovy-dokument-za-10-minut) z firemních dat podle interní šablony. Použij, když uživatel žádá týdenní/měsíční report, přehled metrik nebo shrnutí výkonnosti.
---

# Reporty z dat

## Postup
1. Validuj data skriptem `scripts/validuj_data.py` (viz níže).
2. Načti definice metrik ze souboru METRIKY.md.
3. Report má vždy sekce v tomto pořadí: Souhrn, Klíčové metriky, Trendy, Akční kroky.
4. Souhrn maximálně na 5 vět. Žádné superlativy, jen čísla a změny.
5. Pro každou metriku uveď její definici z METRIKY.md — nikdy nevymýšlej vlastní.

Pozor na pár pravidel pro name: maximálně 64 znaků, jen malá písmena, číslice a spojovníky. Slova „anthropic" a „claude" jsou rezervovaná, použít je nesmíš. description má limit 1024 znaků a musí být neprázdná.

Krok 2: Referenční soubory

Do METRIKY.md dej věci, které se mění zřídka, ale musí být přesné: definice metrik, vzorce, katalog oddělení. Agent si je otevře, jen když bude skutečně psát sekci s metrikami.

Krok 3: Deterministický kód

Skript validuj_data.py spustí agent přes bash, jakmile začne report generovat. Kontrola null hodnot, duplicit, rozsahů datumů. Do kontextu se dostane jen jednořádkový výstup „Validace prošla" případně seznam problémů. Žádný zdlouhavý předvýpočty v promptu.

Kam skill uložit

Umístění závisí na tom, kde Claude provozuješ:

• Claude Code (osobní): ~/.claude/skills/reporty-z-dat/ — bude fungovat ve všech projektech.
• Claude Code (projektový): .claude/skills/reporty-z-dat/ v kořeni repozitáře — sdílíš ho s celým týmem přes git.
• claude.ai: Nastavení → Features → nahrát skill jako ZIP. Funguje na plánech Pro, Max, Team a Enterprise (s povoleným code execution). Skill je osobní, admin ho centrálně nerozšíří.
• Claude API: Vlastní skills nahráješ přes Skills API (endpoint /v1/skills) a spustíš je s parametrem container u nástroje code execution. Pozor: v API kontejneru není přístup k síti a nelze doinstalovávat balíčky za běhu — skripty musí vystačit s předinstalovanými knihovnami.

Bezpečnost: skill je instalace softwaru

Než cizí skill nainstaluješ, představ si, že instaluješ npm balíček. Skill dává agentovi instrukce a kód — a škodlivý skill může agenta navést k věcem, které se neshodují s jeho deklarovaným účelem. Před nasazením si projdi všechny soubory: nečekané síťové volání, přístup k citlivým souborům, operace nesouvisející s účelem. Zvlášť opatrní buď u skills, které stahují data z externích URL — obsah se může změnit i u dřívější důvěryhodného skillu.

Claude Code dává skills plný síťový přístup jako jakémukoli jinému programu na tvém počítači. To je výhodné pro práci, ale znamená to, že důvěra je na tobě.

Kdy se skill vyplatí, a kdy ne

Skill dává smysl, když:

• Opakuješ stejné instrukce napříč konverzacemi. Jednou napsaný postup přestaneš copy-pastovat.
• Máš rozsáhlý doménový kontext. Schéma databáze, interní API, firemní terminologie — tohle do promptu nepatří, do souborů ano.
• Chceš deterministické kroky. Validace dat nebo konverze formátů patří do skriptu, ne do generování.

Naopak skill neřeší: jednorázové úkoly (na to stačí prompt), rychle se mějící kontext (lepší soubor, který agent otevře na požádání) a centrální správu pro velké organizace přes claude.ai — tu dnes Anthropic nenabízí, skills jsou osobní.

Závěr

Claude Skills řeší nejčastější boj každého, kdo s agentem pracuje denně: jak mu předat know-how, aniž bys ho vkládal do každého promptu zvlášť. Adresář se SKILL.md, pár referenčními soubory a jedním skriptem nahradí stovky opakovaných instrukcí — a díky progresivnímu načítání nepálí tokeny, když se právě nepoužívá.

Zkus u sebe jednu věc: otevři posledních deset konverzací s agentem a najdi instrukce, které se v nich opakují. Pokud najdeš alespoň jednu, máš kandidáta na první skill. Základ je jednoduchý — hlavička s popisem, co a kdy, a tělo s postupem. Zbytek si dorosteš podle potřeby.