Claude Skills a Pluginy: Technický pohled na obsah vs. kontejner

Termíny „Claude skill“ a „Claude plugin“ se často zaměňují, což vytváří zmatek pro vývojáře, kteří se snaží rozšířit Claude Code. Ve skutečnosti to není totéž. Pochopení rozdílu není jen akademické cvičení; je zásadní pro efektivní tvorbu, instalaci a ladění vlastních chování.

V SkillProof se těmito mechanismy zabýváme denně. Nečteme jen dokumentaci; instalujeme a spouštíme skills na reálné práci, jak ze surových složek, tak z balíčků pluginů. Z 1877 dovedností, které jsme dosud otestovali, jich naším hodnocením prošlo pouze 1159 (62 %). Dalších 624 vyžadovalo konfiguraci, doplňkový skill nebo integraci, než začaly fungovat, a 94 dosáhlo horšího skóre než základní stav bez skillu – buď se vůbec nespustily, nebo po spuštění zanechaly horší výsledek, než kdyby nebyly nainstalovány vůbec. Tato zkušenost nám dává jasný, praktický pohled na rozdíl mezi Claude skill a pluginem a na to, co byste měli používat.

Nejjednodušší způsob, jak o tom přemýšlet, je tento: skill je obsah – sada instrukcí, která učí Claude nové chování. Plugin je kontejner – distribuční balíček, který může obsahovat jeden nebo více skills spolu s dalšími typy rozšíření.

Tento článek odděluje tyto dva koncepty a používá přesné cesty k souborům a příkazy, které používáme při našem každodenním testování. Probereme, co je skill, co je plugin, jak se instalují a kdy vytvořit jedno oproti druhému.

Co je Claude Code Skill? Atomická jednotka chování

Claude skill je nejzákladnější stavební kámen. Je to doslova složka obsahující soubor s názvem SKILL.md. To je vše. Název složky se stává identifikátorem skillu.

Soubor SKILL.md má jednoduchou dvoudílnou strukturu:

1. YAML Frontmatter: Blok na začátku souboru, uzavřený mezi ---, který definuje metadata skillu. Důležité pole je description. Pole name je volitelné a výchozí hodnotou je název adresáře. Existuje zhruba tucet dalších volitelných polí (allowed-tools, when_to_use, model, paths a podobné), kterých se většina skills nikdy nedotkne.
2. Markdownové instrukce: Pod frontmatterem píšete prostý markdown, který vysvětluje úkol pro Claude. Toto je váš prompt, vaše sada instrukcí, jak provést dané chování.

Je klíčové, že formát SKILL.md neobsahuje složitou syntaxi pro definování funkcí nástrojů, API schémat nebo typů parametrů. Neexistuje žádný povinný blok pro příklady typu few-shot. Celý systém je postaven na přirozeném jazyce.

Nejdůležitějším polem ve frontmatteru je description. Není určeno jen pro lidi; je to primární spouštěč skillu. Když zadáte Claude úkol, prohledá pole description všech nainstalovaných skills, aby našel shodu. Pokud se popis vašeho úkolu shoduje s description skillu, Claude načte jeho markdownové instrukce do svého kontextu, aby řídil svou odpověď. Pokud ho vynecháte, Claude se vrátí k prvnímu odstavci těla textu, který je zřídka napsán tak, aby fungoval jako spouštěč.

Toto je častý bod selhání, který dokumentujeme v našich testech. Viděli jsme mnoho skills s brilantními instrukcemi v těle markdownu, které Claude nikdy nepoužil, protože description ve frontmatteru bylo příliš vágní, příliš specifické nebo zcela chybělo. Skill s popisem jako "Aids in development" se téměř nikdy nespustí. Pro hlubší vhled do toho, co tvoří dobrý skill, se podívejte na náš průvodce co jsou Claude skills.

Jak nainstalovat surový skill

Pokud je skill jen složka, jeho instalace je stejně jednoduchá jako zkopírování této složky na správné místo. Claude Code hledá skills na dvou místech:

1. Globální: ~/.claude/skills/
2. Specifické pro projekt: <your-project-directory>/.claude/skills/

Skills v globálním adresáři jsou dostupné v jakémkoli projektu, který otevřete v Claude Code. Skills v adresáři specifickém pro projekt se načítají pouze tehdy, když pracujete v daném projektu. To je užitečné pro úkoly specifické pro jednu kódovou bázi.

Pro instalaci skillu, který jste stáhli z Git repozitáře, je proces přímou operací se soubory. Například po naklonování repozitáře obsahujícího skill byste spustili:

# Example: Installing a skill into the global directory
cp -r path/to/cloned-repo/the-skill-folder ~/.claude/skills/

Claude Code sleduje tyto adresáře se skills, takže skill, který přidáte, upravíte nebo odstraníte, je načten během aktuální session bez nutnosti restartu. Výjimkou je adresář se skills, který neexistoval při spuštění session; pokud takový vytvoříte, musíte provést restart, aby ho Claude Code začal sledovat.

Neexistuje žádné speciální rozhraní příkazového řádku pro instalaci surového skillu a žádný flag --skill, který by Claude odkázal na soubor SKILL.md pro jednorázové spuštění. Instalace spočívá v zkopírování složky.

Tento přímý, souborový přístup je způsob, jakým instalujeme většinu skills uvedených v našem katalogu. Je jednoduchý, transparentní a snadno se ladí. Podrobnější příklady instalace najdete v našem průvodci instalací Claude skills.

Co je Claude Plugin? Distribuční balíček

Pokud je skill obsah, plugin je přepravní bedna. Plugin je samostatný adresář komponent, který obvykle nese manifest .claude-plugin/plugin.json, jenž obsahuje jeho identifikační metadata (name, description, version, author) a může odkazovat na umístění jeho komponent.

Toto je hlavní rozdíl mezi Claude skill a pluginem: plugin je navržen jako balíček. I když může obsahovat jediný skill, jeho skutečná síla spočívá ve schopnosti zabalit více souvisejících rozšíření dohromady. Plugin může obsahovat:

• Skills: Jednu nebo více složek se SKILL.md.
• Agents: Specializované subagenty, kterým může hlavní agent Claude předat práci.
• Slash Commands: Vlastní příkazy s /, které můžete spouštět přímo v chatovacím rozhraní Claude Code.
• Hooks: Skripty, které se spouštějí automaticky v určitých bodech životního cyklu session.
• MCP Servers: Připojení k serveru Model Context Protocol, takže plugin může v rámci instalace nastavit externí integraci, místo abyste ji museli konfigurovat ručně. Více o tom v našem rozboru skills vs MCP.
• LSP Servers: Připojení k language serverům, která Claude poskytují typové chyby a navigaci v kódu.

Plugin není jen obal pro jeden skill. Je to kompletní sada nástrojů. Například plugin pro konkrétní testovací framework může obsahovat skill pro psaní nových testů, slash command pro jejich spuštění a hook pro spuštění testů před každým commitem. Skill je jen jedním dílkem skládačky.

Jak fungují pluginy a marketplaces

Protože pluginy jsou složitější balíčky, jejich instalační proces je odlišný. Nekopírujete složky pluginů ručně. Používáte marketplaces: marketplace je Git repozitář obsahující soubor .claude-plugin/marketplace.json, který uvádí seznam pluginů, jež nabízí.

Anthropic provozuje oficiální marketplace, claude-plugins-official, který Claude Code přidá automaticky při spuštění, a také komunitní marketplace na anthropics/claude-plugins-community, který si přidáte sami a jehož pluginy prošly automatizovanou validací a bezpečnostní kontrolou. Systém ale není uzavřený: kdokoli může publikovat marketplace umístěním souboru marketplace.json do repozitáře a nic vám nebrání v jeho přidání. Zahrnutí do oficiálního katalogu je na uvážení společnosti Anthropic; vše mimo něj má takovou kvalitu, jakou se rozhodl poskytnout jeho správce.

Pro instalaci pluginu přidáte jeho marketplace a poté nainstalujete plugin podle názvu:

1. Přidání marketplace:

   /plugin marketplace add anthropics/claude-code
   

2. Instalace pluginu:

   /plugin install commit-commands@claude-code-plugins
   

Poté spusťte /reload-plugins pro jeho aktivaci v aktuální session.

Správa pluginů se však neomezuje pouze na interaktivní rozhraní. Existuje skupina příkazů shellu claude plugin (s aliasem claude plugins), která pokrývá install, uninstall, enable, disable, update, list, details, init a validate – což je dokumentovaný způsob instalace bez interaktivního kroku a nástroj, který použijete při skriptování nastavení pro tým:

claude plugin install commit-commands@claude-code-plugins --scope project

Existují také flagy --plugin-dir a --plugin-url pro načtení pluginu pouze pro jednu session, což je způsob, jak si něco vyzkoušet, než se k tomu zavážete.

Rozdíl mezi marketplace a kurátorovaným adresářem je zde důležitý a není to stejná osa jako skill versus plugin. Marketplace je distribuční kanál: informuje vás, že plugin existuje, a nainstaluje ho. Kontrola, pokud vůbec probíhá, je automatizovaná. Nic z toho vám neřekne, zda daná věc bude fungovat na vašem úkolu.

Claude Code Skills vs. Pluginy: Přímé srovnání

Pro naprosto jasné rozlišení je zde přímé srovnání klíčových vlastností:

Vlastnost	Surový skill	Plugin
Definice	Složka se souborem SKILL.md, která definuje jedno chování.	Samostatný adresář komponent, fungující jako balíček.
Klíčový soubor	SKILL.md	.claude-plugin/plugin.json
Rozsah	Jedna sada instrukcí pro jeden úkol.	Balíček skills, agentů, příkazů, hooks, MCP a LSP serverů.
Instalace	Ruční kopírování: cp -r ... ~/.claude/skills/	/plugin install <name>@<market>, nebo claude plugin install
Distribuce	Přímé sdílení složky, Git repozitář.	Přes Marketplace (Git repozitář s manifestem).
Případ užití	Osobní použití, jednoúčelové nástroje, rychlé prototypování.	Týmová distribuce, komplexní sady nástrojů, vícedílná chování.

Jak SkillProof testuje obojí

Naše testovací metodologie je agnostická vůči metodě instalace. Ať už skill dorazí jako surová složka nebo uvnitř balíčku pluginu, náš proces je stejný. Nainstalujeme ho a poté vyhodnotíme výkon podkladových instrukcí v SKILL.md proti standardizované sadě úkolů.

Metoda distribuce nemění chování skillu. Špatně napsaný soubor SKILL.md bude fungovat stejně špatně, ať už ho zkopírujete ručně, nebo nainstalujete pomocí /plugin install.

Ve skutečnosti je opakujícím se selháním, na které narážíme, balíček, který se bezchybně nainstaluje, ale obsahuje skill, který se nikdy nespustí. Instalace proběhne bez chyby, skill se objeví v seznamu, a pak po něm Claude nikdy nesáhne, protože description v jeho SKILL.md je příliš slabé na to, aby odpovídalo čemukoli, co by uživatel skutečně napsal. Nic v procesu instalace na to neupozorní. Zjistíte to pouze tak, že zadáte Claude úkol, který měl skill řešit, a sledujete, jak odpovídá, jako by skill neexistoval – což je přesně test, který provádíme.

Toto je jeden z důvodů, proč 624 z 1877 námi testovaných skills nese verdikt „Funguje s nastavením“ namísto „prošlo“: fungují, ale ne hned po instalaci, a balení má tendenci skrývat důvod.

Mám vytvořit skill, nebo plugin?

To nás přivádí k praktické otázce: když máte pro Claude nové chování, měli byste vytvořit skill, nebo plugin?

Odpověď je jednoduchá: vždy začněte vytvořením skillu.

1. Vytvořte soubor your-skill-name/SKILL.md. Zaměřte se na psaní jasných, efektivních instrukcí a přesného description, které bude snadné spustit. Otestujte ho lokálně zkopírováním do ~/.claude/skills/.

2. Iterujte na SKILL.md, dokud nebude spolehlivě fungovat. To je 99 % práce. Obsah tohoto souboru je to, co přináší hodnotu.

Teprve poté, co máte ověřený, funkční skill, byste měli zvážit jeho zabalení do pluginu. Rozhodnutí vytvořit plugin by mělo být řízeno potřebami distribuce, nikoli složitostí samotného skillu.

Zabalte jako plugin, pokud:

• Dodáváte více než jednu komponentu. Například skill pro generování API dokumentace a slash command /generate-docs pro jeho spuštění pro celý projekt.
• Potřebujete distribuovat sadu skills týmu pomocí jediného, jednoduchého instalačního příkazu.
• Vytváříte pokročilejší rozšíření, které se spoléhá na hooks, subagenty nebo jiné funkce dostupné pouze v pluginech.

Pokud máte jediný skill pro své osobní použití, vytváření pluginu je zbytečná režie. Složka se surovým skillem v ~/.claude/skills/ je jednodušší a přímější.

Závěr: Zaměřte se na skill, ne na obal

Hlavním poznatkem je, že výkon závisí na kvalitě souboru SKILL.md, nikoli na jeho balení. Plugin je distribuční mechanismus, nikoli záruka kvality. Jak ukazují naše data, i čistě zabalené skills selhávají: 94 z těch, které jsme testovali, dosáhlo horšího skóre, než jaké má Claude bez jakéhokoli nainstalovaného skillu.

Rozdíl mezi Claude skills a pluginy není otázkou dobrého vs. špatného, ale rozsahu a účelu. Jedno je instrukce; druhé je krabice, ve které se dodává.

Související čtení: pro podrobný pohled na balení – manifesty, struktura marketplace a co zkontrolovat, než přidáte něčí repozitář – se podívejte na našeho průvodce pluginy pro Claude Code. Co se týče obsahu, co jsou Claude skills popisuje, jak formát funguje, než napíšete svůj první.

Nalezení 1159 skills, které skutečně projdou našimi testy, je důvod, proč jsme vytvořili SkillProof. Pokud chcete přeskočit metodu pokus-omyl, náš katalog testovaných programovacích skills je dobrým místem, kde začít. Pokud si raději nainstalujete sadu, která již byla testována společně, prodáváme balíčky deseti skills podle rolí – Developer Toolkit, Writer Pack, Security & Code Review a pět dalších – za 10 $ každý na /bundles.