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

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:

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):

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

Narzędzia i tokeny.

Podłączanie agentów

Podłączenie agenta krok po kroku.