Çfarë është një "skill" në kontekstin e AI-it, dhe si e ndërtoni një për workflows tuaj?

Question

Accepted Answer

Një **skill** paketeson një workflow të ripërdorshëm, në-kërkesë për një agent AI: **instruksione** për një detyrë të përsëritur (kur ta bëjmë dhe si), plus **skriptet ose burimet opsionale** që agenti ngarkon vetëm kur detyra është relevante. Është ndryshimi midis ri-shpjegimit të një procedure çdo herë dhe mësimit të saj një herë.

## Çfarë është një skill

```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
```

Fitimi është **progressive disclosure**: agenti di që skill-i *ekziston* nga një përshkrim i shkurtër, dhe merr instruksionet e plota dhe skriptet vetëm kur shfaqet një detyrë përputhëse — kështu që dhjetëra skill-a nuk i mbulojnë çdo bisedë.

## Ndërtimi i një

Një skill ka tre pjesë: **trigger**-i (kur), **steps**-et (si), dhe çdo **helper script** (mjete). Mbajeni të fokusuar dhe të përbërshëm — një punë bërë mirë, jo një kosh i plotë.

```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`-i është **trigger**-i — ai i thotë agentit kur të dojë këtë skill. Lista e numëruar është **steps**-et, dhe `validate.sh` është një **helper script** që forcon korrektësinë kështu agenti nuk ka nevojë të arsyetojë rreth formatit nga e fillimi. Sepse skill-i është i vogël dhe me qëllim të vetëm, ai përbëhet në mënyrë të pastër me të tjerët (p.sh. një skill i veçantë "release" mund ta thërrasë atë).

## Pse ka rëndësi

Skill-at shndërrojnë një agent nga një asistent i përgjithshëm që e ri-informoni vazhdimisht në një që di *tuajat* proçedura të përsëritura. Duke paketesuar trigger-in, steps-et, dhe skriptet në një njësi të fokusuar, të përbërshëm që ngarkohet vetëm në kërkesë, ju kodifikoni njohuritë institucionale një herë dhe e ripërdorni në mënyrë të besueshme — duke marrë rezultate konsistente në detyra të përsëritura pa ri-shpjegim, dhe pa paguar koston e kontekstit të çdo workflow-u në çdo kërkesë.