Communitygithub.com

YepAPI/skills

Warenkorb-Zustand mit Zustand + Persistenz, Produktvarianten, Stripe-Checkout, Bestandsverwaltung und Bestelllebenszyklus.

Was ist skills?

Diese Fähigkeit definiert eine vollständige E-Commerce-Implementierung für KI-Agenten, die mit Online-Shops arbeiten. Sie setzt auf Zustand mit localStorage-Persistenz für den Warenkorbzustand, sodass dieser Seitenaktualisierungen und das Schließen von Tabs übersteht. Produktvarianten werden als separate SKUs mit einem gemeinsamen übergeordneten Produkt modelliert, jede mit eigenem Preis, Bestand und Bild. Der Checkout-Prozess nutzt serverseitige Stripe Checkout Sessions, wobei Preise niemals vom Client gesendet werden. Die Bestandsverwaltung erfolgt serverseitig vor der Checkout-Erstellung mit Transaktionsschutz gegen Race Conditions. Der Bestelllebenszyklus durchläuft die Phasen 'pending' → 'paid' → 'shipped' → 'delivered', wobei Statusänderungen ausschließlich über Webhook-Ereignisse (nicht Client-Aktionen) erfolgen. Die Fähigkeit unterstützt gängige KI-Agenten-Plattformen wie Claude Code, Cursor und Codex und bietet klare Regeln, Implementierungsmuster (inkl. eines vollständigen Zustand-Stores) sowie Anti-Patterns zur Vermeidung typischer Fallstricke.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/e-commerce

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

E-Commerce

Regeln

  • Warenkorbzustand: Zustand-Store mit localStorage-Persistenz – übersteht Seitenaktualisierung und Tab-Schließen
  • Produktvarianten: Als separate SKUs mit gemeinsamem übergeordnetem Produkt modellieren – jede Variante hat eigenen Preis, Bestand, Bild
  • Checkout: Stripe Checkout Sessions (serverseitig) – Preise niemals vom Client senden
  • Bestand: Lagerbestand serverseitig vor Erstellung der Checkout-Session prüfen – Race-Condition-Schutz durch Datenbanktransaktionen
  • Bestelllebenszyklus: pending → paid → shipped → delivered – Aktualisierung über Webhook-Ereignisse, nicht durch Client-Aktionen
  • Produktliste: Serverseitiges Filtern/Sortieren/Paginieren – URL-Suchparameter für teilbare gefilterte Ansichten
  • Preise: In Cent speichern (Ganzzahlen) – Anzeige mit Intl.NumberFormat und Währungscode
  • Warenkorboperationen: Hinzufügen, Entfernen, Mengenaktualisierung, Leeren – Bestand bei jeder Warenkorbaktion validieren

Muster

// Zustand-Warenkorb-Store mit Persistenz
import { create } from "zustand";
import { persist } from "zustand/middleware";

interface CartItem { productId: string; variantId: string; quantity: number; price: number; }
interface CartStore {
  items: CartItem[];
  addItem: (item: CartItem) => void;
  removeItem: (variantId: string) => void;
  updateQuantity: (variantId: string, quantity: number) => void;
  clear: () => void;
  total: () => number;
}

export const useCart = create<CartStore>()(
  persist(
    (set, get) => ({
      items: [],
      addItem: (item) => set((state) => {
        const existing = state.items.find((i) => i.variantId === item.variantId);
        if (existing) {
          return { items: state.items.map((i) =>
            i.variantId === item.variantId ? { ...i, quantity: i.quantity + item.quantity } : i
          )};
        }
        return { items: [...state.items, item] };
      }),
      removeItem: (variantId) => set((s) => ({ items: s.items.filter((i) => i.variantId !== variantId) })),
      updateQuantity: (variantId, quantity) => set((s) => ({
        items: quantity <= 0
          ? s.items.filter((i) => i.variantId !== variantId)
          : s.items.map((i) => (i.variantId === variantId ? { ...i, quantity } : i)),
      })),
      clear: () => set({ items: [] }),
      total: () => get().items.reduce((sum, i) => sum + i.price * i.quantity, 0),
    }),
    { name: "cart-storage" }
  )
);

Vermeiden

  • Preise vom Client senden, um einen Checkout zu erstellen – Preise immer serverseitig aus der Datenbank auflösen
  • Warenkorb nur im React-Status speichern – persistierten Zustand oder localStorage verwenden, damit der Warenkorb eine Aktualisierung übersteht
  • Bestand bei "In den Warenkorb" abbuchen – Bestand erst beim Checkout reservieren, bei Sitzungsablauf freigeben
  • Bestellstatus vom Client aktualisieren – Stripe-Webhooks für checkout.session.completed verwenden
  • Fließkommazahlen für Geldbeträge – als Ganzzahlen (Cent) speichern, nur zur Anzeige formatieren

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Verwandte Skills