Communitygithub.com

BIGboss248/nextjs-wordpress

Schritt-für-Schritt-Workflow zum Entwerfen und Entwickeln von Next.js App Router-Seiten (RSC page.tsx, Lade-Skeleton, Metadaten, JSON-LD-Schema und dynamische statische Parameter). Wird durch Begriffe wie "/nextjs-page-dev", „create page“, „new page“, „develop page“, „build route“ oder „implement page“ ausgelöst.

Was ist nextjs-wordpress?

Diese Fähigkeit automatisiert die Erstellung production-ready Next.js App Router-Seiten mit asynchronen Routenparametern, lokalisierten Übersetzungswörterbüchern, dynamischen Metadaten, typsicheren JSON-LD-Strukturierten Daten (mittels `schema-dts`) und statischer Vorab-Generierung. Sie ist für Cursor, Claude Code und Codex optimiert und stellt sicher, dass Entwickler schnell, konsistent und fehlerresistent arbeiten können. Der Workflow umfasst fünf Schritte: Planung mit Projektkontext und Routen-Registry, Befüllung der Übersetzungswörterbücher, Erstellung von Lade-Skeletons (`loading.tsx`), Implementierung der Seitenkomponente (`page.tsx`) und abschließende Verifikation mittels PowerShell- oder Bash-Skripten. Besondere Stärken liegen in der automatischen Verknüpfung mit Referenzdokumenten für Streaming, SEO und Seitenkonventionen sowie in der modularen Wiederverwendbarkeit von Templates. Der Skill setzt auf „Zero Hardcoding“: Kein Text wird direkt in JSX geschrieben, sondern stets über internationalisierte Wörterbücher eingebunden. Dynamische Metadaten, kanonische URLs und JSON-LD-Strukturierte Daten werden typisiert generiert. Statische Pfade werden automatisch über `generateStaticParams` vorkonfiguriert. Das Ergebnis sind performante, suchmaschinenoptimierte und barrierefreie Next.js-Seiten mit granularer Suspense-Down-Push-Architektur und optimierten Ladezuständen. Die gesamte Entwicklung bleibt dabei transparent und nachvollziehbar – jede Änderung wird geplant und freigegeben, bevor Code generiert wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BIGboss248/nextjs-wordpress/tree/HEAD/.agents/skills/nextjs-page-dev

In Ihrer bevorzugten KI fragen

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

Dokumentation

Entwicklung von Next.js-Seiten und -Routen (nextjs-page-dev)

Spezialisierter Workflow zum Erstellen production-ready Next.js App Router-Seiten mit asynchronen Routenparametern, lokalisierten Übersetzungswörterbüchern, dynamischen Metadaten, typsicheren JSON-LD-Strukturierten Daten (schema-dts) und statischer Vorab-Generierung.

[!TIP] Modulare Assets & Vertiefungshandbücher:


Architekturregeln und Standards

1. Planungskontext & Routen-Registry

  • Lies docs/project.json, um supported_languages, dictionaries_dir (Standard: "messages") und new_component_dir zu ermitteln.
  • Alle Navigations-URLs MÜSSEN auf ROUTES aus @/lib/routes oder @/i18n/navigation verweisen.
  • Zielpfad-Hierarchie der Seite: app/[locale]/<route-path>/page.tsx (oder app/<route-path>/page.tsx für nicht-lokalisierte Seiten).

2. Keine hartcodierten Texte & Befüllung der Wörterbücher

  • Keine hartcodierten Texte: Seitenüberschriften, Titel, Beschreibungen und statische Labels MÜSSEN vor dem Schreiben von JSX in messages/[locale].json für alle supported_languages hinzugefügt werden.
  • RSC-Übersetzungen: Lies Übersetzungen in Server-Komponenten mit await getTranslations('<namespace>').

3. SEO, Metadaten & JSON-LD

  • Dynamische Metadaten: Exportiere generateMetadata({ params, searchParams }: Props), das dynamischen title, description und kanonische URL (alternates: { canonical: ... }) bereitstellt.
  • Strukturierte Daten: Injiziere typisierte JSON-LD mit schema-dts (WithContext<T>), eingewickelt in <script type="application/ld+json">, wobei <-Zeichen als \u003c escaped werden.
  • Konsultiere references/seo-structured-data-guide.md für Schemata.

4. Statische Vorab-Generierung (generateStaticParams)

  • Wenn die Seite unter einem dynamischen Segment [locale] (oder einem anderen dynamischen Segment) verschachtelt ist und supported_languages mehr als eine Sprache enthält, exportiere generateStaticParams(), das { locale } für alle unterstützten Sprachen zurückgibt.

5. Sofortnavigation & Granulares Suspense-Herunterschieben

  • Granulare Ladezustände: Schiebe <Suspense> nach unten zu spezifischen dynamischen Unterkomponenten, sodass statische/zwischengespeicherte Abschnitte (Header, Hero, zwischengespeicherte Produktinfo) sofort in die Statische Shell und App Shell gehoben werden.
  • Opt-Out: Wenn ein Segment inhärent dynamisch ist und keine Sofortrückmeldung gewünscht wird, konfiguriere export const instant = false.
  • Konsultiere references/streaming-and-boundaries.md für Streaming-Muster.

Workflow-Schritte

  • Schritt 0: Implementierungsplanung & Genehmigungshürde

    • Lies docs/project.json und die Zielroutendefinition in lib/routes.ts.
    • Formuliere Seitenmetadaten, JSON-LD-Schema-Typ, Übersetzungs-Namespaces und Komponenten-Layout.
    • Lege dem Benutzer einen prägnanten Implementierungsplan vor, falls größere neue Seiten erstellt werden.
  • Schritt 1: Übersetzungswörterbücher befüllen

    • Füge Seitentitel, Meta-Beschreibung und Seitenkörpertext in allen Locale-Dateien (messages/en.json, messages/fa.json usw.) unter einem eigenen Seiten-Namespace hinzu.
  • Schritt 2: Begleit-Skelette erstellen (loading.tsx)

    • Falls die Seite Inhalte streamt oder Daten abruft, setze loading.tsx basierend auf loading.tsx.template ein.
  • Schritt 3: Seitenkomponente implementieren (page.tsx)

    • Setze page.tsx.template ein und passe es an:
      1. Definiere das asynchrone Props-Interface (params: Promise<{ locale: string, ... }>, searchParams).
      2. Exportiere generateMetadata(), das dynamische Titel und kanonische Alternativen auflöst.
      3. Exportiere generateStaticParams() für lokalisierte/dynamische Routen.
      4. Implementiere die RSC-Seite, die Abschnittskomponenten aus <new_component_dir>/<page-name>/ zusammensetzt.
      5. Rendere die <JsonLd>-Komponente für strukturierte Daten.
  • Schritt 4: Verifikation & Plausibilitätsprüfung

    • Führe das Seitenverifikationsskript aus:
      • Windows (PowerShell):
        pwsh .agents/skills/nextjs-page-dev/scripts/verify-page.ps1 -RoutePath <route_dir>
        
      • Linux / macOS (Bash):
        bash .agents/skills/nextjs-page-dev/scripts/verify-page.sh <route_dir>
        
    • Stelle sicher, dass keine TypeScript-Fehler oder fehlende Wörterbuchfehler auftreten.
  • Schritt 5: Checkliste Implementierungsplan synchronisieren

    • Hake die abgeschlossenen Seiteninfrastruktur-Elemente (page.tsx, loading.tsx, error.tsx, generateMetadata, JSON-LD Schema, generateStaticParams()) in docs/plan/05-pages-and-components.md ab.
    • Wenn alle Unterchecklisten für die Komponenten und alle Seiteninfrastruktur-Aufgaben für diese Seite abgeschlossen sind, hake das übergeordnete Seiten-Element ab (- [x]).

Individual skills in this repo

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

BIGboss248/nextjs-wordpress

Create, configure, manage, and validate Google Antigravity customizations including skills, rules, MCP servers, lifecycle hooks, plugins, and custom JSON configs. Use when adding new capabilities to Antigravity, configuring MCP servers, writing rules, creating skills, setting up hooks, or modernizing legacy workflows.

BIGboss248/nextjs-wordpress

Spawn multiple agents into a shared conversation where they debate, disagree, and converge on a solution via a shared chat.json file. Use for architecture decisions, code review debates, design trade-offs, or any problem that benefits from adversarial reasoning. Triggers on "chatroom", "agent debate", "have agents discuss", "agent chatroom", "debate this", or /agent-chatrooms. Also triggers on phrases like "have 3 agents argue about", "multi-agent discussion", or "let them debate".

BIGboss248/nextjs-wordpress

Always-active code intelligence, search, and navigation skill utilizing the codebase-memory MCP server. Enforces an index-first protocol (verifying and refreshing the knowledge graph via index_repository or index_status before searching, required because background auto_watch is disabled to eliminate editor stutter and system lag), followed by graph-first exploration (search_graph, trace_path, get_code_snippet, query_graph, get_architecture, detect_changes) instead of naive text grep or full-file reads. Always activate before searching the codebase, inspecting unknown architecture, finding symbols, or tracing callers/callees.

BIGboss248/nextjs-wordpress

>- Discover, interview, and craft comprehensive UX/UI design specifications (design-spec.md) and design tokens for web components. Triggers on "/component-design", "design component", "design section", "design UI", "wireframe component", or "create design spec".

BIGboss248/nextjs-wordpress

>- Configure and query WooCommerce APIs including WPGraphQL, WooGraphQL, and JWT auth for headless frontends. Use when connecting Next.js to WooCommerce or fetching store catalog data.

BIGboss248/nextjs-wordpress

Orchestrate parallel browser automation using multiple Chrome DevTools MCP instances. Use when a task requires doing the same browser action across many targets simultaneously (e.g., submitting contact forms, filling applications, scraping pages that need JS rendering). Spin up 1-5 parallel Chrome agents.

BIGboss248/nextjs-wordpress

Workflow for spawning an independent subagent to conduct unbiased code reviews and inject adversarial edge-case tests ([ComponentName].edge.test.tsx).

BIGboss248/nextjs-wordpress

>- Build Next.js App Router React components with Suspense skeletons, semantic OKLCH tokens, Jest + RTL unit tests, Playwright visual/hydration checks, and Tailwind logical styling. Triggers on "/nextjs-component-dev", "create component", "new component", "build component", or "develop component".

BIGboss248/nextjs-wordpress

>- Bootstrap, configure, and verify the complete Next.js App Router development environment, developer tooling, testing suites, MCP servers, Docker containerization, and CI/CD. Triggers on "/nextjs-dev-setup", "setup nextjs dev environment", "start a nextjs project", or "containerize nextjs app".

BIGboss248/nextjs-wordpress

>- Configure production health monitoring endpoints (/api/health), Docker Compose probes, and runtime metrics in Next.js App Router applications. Use when asked to "setup health check", "add health endpoint", "docker compose healthcheck nextjs", "configure health monitor", or "/nextjs-healthcheck".

BIGboss248/nextjs-wordpress

Bootstrap, configure, and verify next-intl App Router internationalization (proxy.ts/middleware.ts, next/root-params, [locale] layout, routing). Triggers on "/nextjs-i18n-setup", "setup i18n", "install next-intl", "configure next-intl", "add internationalization", "setup locale routing", "migrate to [locale]".

BIGboss248/nextjs-wordpress

Read/write translation dictionaries (messages/[locale].json), next-intl hooks (getTranslations/useTranslations), providers (Storybook/tests/subtrees), and BiDi styling. Triggers on "/nextjs-i18n-usage", "i18n dictionary", "use translations", "read dictionary", "i18n provider", "next-intl hooks", "storybook i18n", "test i18n", "add translation keys", "localize component", "create a component", "update a component".

BIGboss248/nextjs-wordpress

>- Configure, test, and verify OpenTelemetry (OTel) observability in Next.js App Router applications. Triggers on "/nextjs-otel", "setup otel", "configure opentelemetry", "test otel", or "verify opentelemetry".

BIGboss248/nextjs-wordpress

>- Orchestrate end-to-end planning for Next.js App Router projects, generating canonical specifications, design systems, and a 7-phase modular implementation roadmap in docs/plan/. Triggers on "/nextjs-plan", "plan a nextjs project", "plan nextjs app", "create nextjs project plan", "outline nextjs architecture", or "generate plan".

BIGboss248/nextjs-wordpress

Workflow and engineering standards for crafting co-located Storybook CSF3 stories ([ComponentName].stories.tsx) with interactive controls, action spies, and 4 canonical theme variants.

BIGboss248/nextjs-wordpress

>- Build Next.js e-commerce frontends backed by WooCommerce APIs, handling ISR catalogs, cart sessions, and JWT authentication. Use when building or querying Next.js stores with WooCommerce.

BIGboss248/nextjs-wordpress

Self-correcting rules engine and feedback loop that learns from user corrections, mistakes, and project-specific constraints by maintaining a persistent autofix ruleset. Scans learned rules before starting any task, resolves conflicts, and automatically appends new rules upon corrections. Triggers on user corrections ("no, do it this way", "never do X", "always use Y"), /learn, "self repair", "add rule", "update rules", or when diagnosing assumptions and bugs. CRITICAL ALWAYS-ACTIVE LIFECYCLE SKILL. Must always be kept in context, loaded at session start, and consulted before starting ANY task to read and apply active constraints from autofix.json. MUST ALWAYS be triggered immediately whenever the user provides ANY correction, preference, criticism, rejection of an approach, or adjustment ("no", "don't do X", "use Y", "remember", "prefer"), or when any mistake/bug is identified. Automatically and immediately formulates and appends the new imperative rule to the project's autofix.json ruleset file.

BIGboss248/nextjs-wordpress

Setup, automate, and execute SEO audits, CI/CD pre-push/pre-deploy checks, and ranking optimizations using the seo CLI and MCP server.

BIGboss248/nextjs-wordpress

End-to-end repository onboarding and development environment setup skill. Scans repository structure, configures project metadata (docs/project.json), sets up the codebase-memory-mcp code intelligence knowledge graph server (in workspace mcp.json and globally for AGY only), configures git hooks with Husky and Commitlint, establishes multi-stage production Docker containerization, and automates credit-optimized Release Please CI/CD with multi-arch (AMD64 & ARM64) GHCR package deployment. Triggers on "/setup-repository", "setup repository", "setup repo", "initialize repository", "new repo setup", or when preparing any repository for development and AI agent workflows.

BIGboss248/nextjs-wordpress

AI screen scaffolding, layout generation, and variant exploration workflow powered by Google Stitch (StitchMCP). Consumes a component design specification (docs/design/components/[page name]/[component name]/design-spec.md), verifies and reuses the central Stitch project in docs/project.json (or creates/persists one if absent), seeds the project's design system into Stitch, synthesizes layout prompts to generate a screen and create one variant of the given design spec file, downloads and saves Stitch JPG screenshots and HTML code files directly into docs/design/components/[page name]/[component name]/stitch/ using binary-safe PowerShell Invoke-WebRequest, outputs image prompts to the user if visual assets are needed (without calling generate_image to conserve tokens), updates design-spec.md with Stitch layout benchmarks, and audits asset download integrity with an independent subagent. Triggers on "/stitch-design", "generate stitch screen", "create stitch variant", "scaffold screen with stitch", or "stitch...

Verwandte Skills