> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Skille agentowe

> Gotowe instrukcje dla agentów AI: jak budować strony, motywy, katalog i kasę na ItemShop.

Skill to paczka instrukcji i przykładów, którą agent AI wczytuje, gdy zadanie tego wymaga — np. „zmień kolory strony” albo „przenieś sklep z konfiguratora”. Dzięki skillom agent zna konwencje ItemShop (SDK, `site.config.ts`, zasady kasy) i nie musi ich zgadywać.

Każdy skill to folder w formacie [Agent Skills](https://code.claude.com/docs/en/skills): `SKILL.md` (nazwa i opis *kiedy* użyć) oraz `references/` i `examples/`, które agent ładuje dopiero w razie potrzeby. Skille są open source (MIT) w repozytorium `itemshop-sdk`, katalog `skills/`.

## Katalog

| Skill | Do czego |
| - | - |
| `itemshop-storefront` | **Zacznij tutaj.** Struktura projektu, `itemshop.site.json`, `site.config.ts` i pętla edytuj → build → podgląd → publikacja. |
| `itemshop-theme` | Kolory, fonty, układ, motyw jasny/ciemny, dostępność, mobile i checklista jakości przed publikacją. |
| `itemshop-catalog` | Produkty, kategorie (serwery), warianty, pakiety z bonusem, ceny, tłumaczenia oraz kody rabatowe i vouchery przez MCP. |
| `itemshop-checkout` | Czego **nie wolno** zmieniać w koszyku i kasie (zgody, Turnstile, przekierowanie do płatności, status po numerze i kluczu, grupy płatności) i jak je bezpiecznie ostylować. |
| `itemshop-seo` | Tytuł i opis, Open Graph, canonical/hreflang, JSON-LD, sitemap, wydajność. |
| `itemshop-migrate-legacy` | Przeniesienie ustawień ze starego konfiguratora do `site.config.ts`. |
| `itemshop-sdk` | Oficjalne SDK (TS, Python, PHP, Java/Kotlin, Go) w botach, pluginach i własnych stronach. |

Katalog jest dostępny też jako API (`GET /skills`) i przez `npx itemshop skills list`.

## Zanim zainstalujesz

Skille mówią agentowi **jak** coś zrobić, a [serwer MCP](https://andcze.mintlify.site/pl/developers/mcp.md) daje mu **narzędzia**, żeby to zrobić na Twoim sklepie. Najpierw podłącz MCP (`npx itemshop mcp config --agent <id>` wypisze konfigurację, a w panelu **Workspace → Agent** są gotowe fragmenty do skopiowania).

## Instalacja

**Wbudowany agent**

Nic nie instalujesz — skille ładują się automatycznie.

**Claude Code**

```bash theme={null}
npx itemshop skills add itemshop-storefront        # → .claude/skills/itemshop-storefront
npx itemshop skills add itemshop-theme --force     # aktualizacja
```

Możesz też skopiować folder ręcznie do `.claude/skills/<id>/` (projekt, wspólny przez git) albo `~/.claude/skills/<id>/` (osobisty). Claude czyta opisy przy starcie i ładuje cały skill, gdy zadanie pasuje; `/itemshop-theme` wywołuje skill po nazwie.

**Codex, OpenCode, Gemini CLI, Cursor, Windsurf, Aider**

Te agenty nie ładują `SKILL.md` natywnie, więc zainstaluj foldery w repozytorium i wskaż je w pliku instrukcji agenta:

```bash theme={null}
npx itemshop skills add itemshop-storefront --dir .itemshop/skills
npx itemshop skills add itemshop-theme --dir .itemshop/skills
```

Dopisz do `AGENTS.md` (Codex, OpenCode, Cursor, Windsurf), `GEMINI.md` (Gemini CLI) lub `CONVENTIONS.md` (Aider):

```markdown theme={null}
## ItemShop skills
This is an ItemShop storefront project. Before changing it, read `.itemshop/skills/itemshop-storefront/SKILL.md`.
Then read the matching skill for the task and load its `references/` only when needed:
- look & feel -> `.itemshop/skills/itemshop-theme/SKILL.md`
- products/prices/discounts -> `.itemshop/skills/itemshop-catalog/SKILL.md`
- cart/checkout -> `.itemshop/skills/itemshop-checkout/SKILL.md` (never change consents, Turnstile or the payment redirect)
- SEO/performance -> `.itemshop/skills/itemshop-seo/SKILL.md`
- moving old settings -> `.itemshop/skills/itemshop-migrate-legacy/SKILL.md`
- SDK usage -> `.itemshop/skills/itemshop-sdk/SKILL.md`
```

Panel (**Workspace → Agent**) generuje ten blok razem z konfiguracją MCP dla wybranego agenta. Cursor może zamiast tego użyć reguły `.cursor/rules/*.mdc` z tym samym tekstem.

> **[Serwer MCP](https://andcze.mintlify.site/pl/developers/mcp.md)**
>
> Narzędzia i tokeny.

> **[Podłączanie agentów](https://andcze.mintlify.site/pl/site/agents.md)**
>
> Podłączenie agenta krok po kroku.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.