Czym jest "umiejętność" (skill) w kontekście AI i jak ją zbudować do swojego przepływu pracy?

Question

Accepted Answer

**Umiejętność** (skill) pakuje wielokrotnie używalny, dostępny na żądanie przepływ pracy dla agenta AI: **instrukcje** dla zadania powtarzającego się (kiedy je wykonać i jak), plus **opcjonalne skrypty lub zasoby**, które agent ładuje tylko wtedy, gdy zadanie jest istotne. To różnica między ponownym wyjaśnianiem procedury za każdym razem a nauczaniem jej raz.

## Czym jest umiejętność

```text
SKILL = a self-contained folder the agent can pull in on demand:
  SKILL.md   → metadata + instructions (the TRIGGER + the STEPS)
  scripts/   → optional helper scripts the agent runs (e.g. a linter, a generator)
  resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
```

Zaletą jest **progresywne ujawnianie**: agent wie, że umiejętność *istnieje* z krótką opisem i ładuje pełne instrukcje i skrypty tylko wtedy, gdy pojawi się pasujące zadanie — dzięki temu dziesiątki umiejętności nie obciążają każdej rozmowy.

## Budowanie umiejętności

Umiejętność ma trzy części: **wyzwalacz** (kiedy), **kroki** (jak) oraz ewentualne **skrypty pomocnicze** (narzędzia). Utrzymuj ją skoncentrowaną i składającą się — jedno zadanie wykonane dobrze, nie wszystko na raz.

```markdown
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry

## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
```

`description` to **wyzwalacz** — mówi agentowi, kiedy sięgnąć po tę umiejętność. Lista numerowana to **kroki**, a `validate.sh` to **skrypt pomocniczy**, który egzekwuje poprawność, aby agent nie musiał rozumować od zera na temat formatu. Ponieważ umiejętność jest mała i jednocelu, komponuje się czyszczą z innymi (np. oddzielna umiejętność "release" może ją wywołać).

## Dlaczego to ważne

Umiejętności zmieniają agenta z ogólnego asystenta, który musisz stale instruować, w tego, który zna *twoje* powtarzające się procedury. Pakując wyzwalacz, kroki i skrypty w skoncentrowaną, składającą się jednostkę, która ładuje się tylko na żądanie, kodujesz wiedzę instytucjonalną raz i wielokrotnie ją wykorzystujesz — osiągając spójne wyniki w powtarzalnych zadaniach bez ponownego wyjaśniania ich i bez ponoszenia kosztów kontekstu każdego przepływu pracy na każde żądanie.