Communitygithub.com

YepAPI/skills

Upload-Handling, Größenänderung/Komprimierung, CDN-Auslieferung, Unschärfe-Platzhalter und next/image-Muster.

Was ist skills?

Dieses Skill bietet eine umfassende Lösung zur Bildoptimierung in Next.js-Anwendungen. Es automatisiert den gesamten Workflow vom Upload über die server-seitige Größenänderung und Komprimierung mit `sharp` bis zur Auslieferung über ein CDN. Dabei werden bewährte Verfahren wie die Verwendung von `next/image` für automatische Optimierung, Lazy Loading und responsive srcsets sichergestellt, um Layout-Verschiebungen (CLS) zu vermeiden. Zusätzlich unterstützt es die Generierung von `blurDataURL`-Platzhaltern zur Verbesserung der Wahrnehmung der Ladeleistung. Das Skill definiert klare Regeln für Dateigrößenlimits, Formatkonvertierung (WebP/AVIF) und die sichere Konfiguration von Remote-Image-Quellen. Entwickler erhalten konkrete Codebeispiele für die Integration in ihre Projekte, einschließlich der serverseitigen Bildverarbeitung mit der `sharp`-Bibliothek und der korrekten Verwendung der `Image`-Komponente von Next.js. Ziel ist es, eine performante, zugängliche und benutzerfreundliche Bildverarbeitung zu gewährleisten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Bildoptimierung

Regeln

  • Verwende next/image für alle Bilder in Next.js – automatische Optimierung, Lazy Loading, responsive srcsets
  • Setze immer width und height oder verwende fill mit einem dimensionierten Container – verhindert Layout-Verschiebungen (CLS)
  • Unschärfe-Platzhalter: Generiere blurDataURL zum Build-/Upload-Zeitpunkt mit plaiceholder oder verwende placeholder="blur" für statische Importe
  • Remote-Bilder: Konfiguriere remotePatterns in next.config.js – Whitelist für CDN-Domains
  • Upload-Ablauf: Client → Presigned-URL (S3/R2/Supabase Storage) → direkter Upload → URL in Datenbank speichern
  • Größenänderung beim Upload: Verwende sharp serverseitig, um mehrere Größen zu erstellen (Thumbnail, Medium, Voll) – liefere keine Originale aus
  • Formate: Serviere WebP/AVIF über next/image-Auto-Format – Fallback auf JPEG für Kompatibilität
  • CDN-Auslieferung: Speichere Originale im Objektspeicher (S3, R2), liefere über CDN (CloudFront, Cloudflare) mit Cache-Headern aus
  • Dateigrößen-Validierung: Prüfe auf Client (vor dem Upload) und Server (vor der Verarbeitung) – typisches Limit: 5-10 MB

Muster

// next/image mit Unschärfe-Platzhalter
import Image from "next/image";

<Image
  src="/hero.jpg"
  alt="Hero-Bild"
  width={1200}
  height={630}
  placeholder="blur"
  blurDataURL="data:image/jpeg;base64,/9j/4AAQ..."
  priority // oberhalb des Falzes
/>

// Füllmodus für dynamische Container
<div className="relative aspect-video">
  <Image src={url} alt={alt} fill className="object-cover" sizes="(max-width: 768px) 100vw, 50vw" />
</div>
// Serverseitige Größenänderung mit sharp
import sharp from "sharp";

async function processUpload(buffer: Buffer) {
  const thumbnail = await sharp(buffer).resize(200, 200, { fit: "cover" }).webp({ quality: 80 }).toBuffer();
  const medium = await sharp(buffer).resize(800).webp({ quality: 85 }).toBuffer();
  const full = await sharp(buffer).resize(1920).webp({ quality: 90 }).toBuffer();
  return { thumbnail, medium, full };
}

Vermeiden

  • Verwendung von <img>-Tags in Next.js – verlierst automatische Optimierung, Lazy Loading und Formatkonvertierung
  • Fehlendes sizes-Attribut bei responsiven Bildern – Browser kann nicht die richtige srcset-Größe auswählen
  • Auslieferung von unverkleinerten Originalen – ein 5 MB Foto, das mit 400px angezeigt wird, ist verschwenderisch
  • Überspringen der Dateityp-Validierung – Prüfe den MIME-Typ serverseitig, nicht nur die Dateierweiterung

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

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

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

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

Verwandte Skills