Scrells
zaawansowanydla developerów

Pisanie własnych Claude Code skills

Zaawansowany przewodnik dla developerów: budowa własnych skills.

Skills to sposób na spakowanie powtarzalnego workflow w komendę, którą Claude Code wykonuje za Ciebie. W tym artykule zbudujemy skill od zera.

Struktura skilla

Każdy skill to katalog z plikiem SKILL.md. Sekcja frontmatter opisuje, kiedy skill ma się uruchamiać — to najważniejsze linie całego pliku:

SKILL.md
---
name: new-article
description: >
  Scaffolduje nowy artykuł MDX z poprawnym frontmatterem
  (audience, level, series) i checklistą SEO.
---


# Nowy artykuł


1. Zapytaj o tytuł, audience i level.
2. Utwórz plik w src/content/blog/ ze slugiem z tytułu.
3. Wypełnij frontmatter zgodnie ze schematem kolekcji.

Instalacja skilla w projekcie

Skill umieszczasz w katalogu .claude/skills/ w repo projektu:

Terminal window
mkdir -p .claude/skills/new-article
touch .claude/skills/new-article/SKILL.md

Iterowanie na opisie

Opis skilla decyduje o tym, kiedy Claude go użyje. Zbyt ogólny opis powoduje przypadkowe uruchomienia — doprecyzuj go zamiast rozszerzać:

SKILL.md
description: Tworzy artykuły.
description: Scaffolduje nowy artykuł MDX bloga z frontmatterem wg schematu kolekcji.

Podsumowanie

Dobry skill jest mały, ma precyzyjny opis i odtwarza konwencje projektu zamiast wymyślać własne. Zacznij od jednego workflow, który powtarzasz najczęściej.