i18n/de/skills/scaffold-nextjs-app/SKILL.md
Next.js-Anwendung mit App Router, TypeScript, ESLint und optionalem Tailwind CSS erstellen. Behandelt Projektstruktur, Routing-Konventionen, Umgebungsvariablen und lokale Entwicklungsverifikation. Verwenden, wenn ein neues Next.js-Projekt mit modernen Konventionen gestartet wird oder eine bestehende Pages-Router-App auf App Router migriert werden soll.
npx skillsauth add pjt222/agent-almanac scaffold-nextjs-appInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Eine neue Next.js-Anwendung mit App Router, TypeScript und modernen Konventionen scaffolden, bereit für die Entwicklung.
my-app)src/-Layout — Standard: ja)Das offizielle Create-Next-App-Tool ausführen.
npx create-next-app@latest my-app \
--typescript \
--eslint \
--tailwind \
--src-dir \
--app \
--import-alias "@/*"
Wenn interaktive Prompts erscheinen:
src/-Verzeichnis: Yes@/* (Standard)Erwartet: Projektverzeichnis my-app/ mit vollständiger Struktur erstellt. Keine Fehler während der Installation.
Bei Fehler: Wenn npx nicht verfügbar ist, Node.js (>= 18) installieren. Wenn Netzwerkfehler auftreten, erneut versuchen oder --use-npm explizit angeben.
Sicherstellen, dass das Scaffold die erwartete App-Router-Struktur erzeugt hat.
my-app/
├── src/
│ └── app/
│ ├── layout.tsx # Root-Layout (erforderlich)
│ ├── page.tsx # Startseite (/)
│ ├── globals.css # Globale Stile
│ └── favicon.ico
├── public/ # Statische Assets
├── next.config.js # Next.js-Konfiguration
├── tailwind.config.ts # Tailwind-Konfiguration (wenn aktiviert)
├── tsconfig.json # TypeScript-Konfiguration
├── package.json
└── .eslintrc.json
Erwartet: Alle aufgelisteten Dateien vorhanden. src/app/layout.tsx enthält Root-RootLayout-Komponente mit HTML- und Body-Tags.
Bei Fehler: Wenn das src/-Verzeichnis fehlt, wurde --src-dir möglicherweise nicht gesetzt. Manuell src/app/ erstellen und Dateien dorthin verschieben.
src/app/layout.tsx mit geeignetem Titel und Metadaten aktualisieren.
// src/app/layout.tsx
import type { Metadata } from 'next'
import { Inter } from 'next/font/google'
import './globals.css'
const inter = Inter({ subsets: ['latin'] })
export const metadata: Metadata = {
title: 'My App',
description: 'Generated by create next app',
}
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body className={inter.className}>{children}</body>
</html>
)
}
Erwartet: Layout kompiliert ohne TypeScript-Fehler. Metadaten-Objekt hat title und description.
Bei Fehler: Wenn Font-Imports fehlschlagen, die Font-Importe entfernen und zu Standard-System-Fonts wechseln: <body className="font-sans">.
src/app/page.tsx durch eine saubere Startseite ersetzen.
// src/app/page.tsx
export default function Home() {
return (
<main className="flex min-h-screen flex-col items-center justify-center p-24">
<h1 className="text-4xl font-bold">Welcome to My App</h1>
<p className="mt-4 text-lg text-gray-600">
Get started by editing{' '}
<code className="font-mono text-blue-600">src/app/page.tsx</code>
</p>
</main>
)
}
Erwartet: Seite rendert ohne Fehler. Tailwind-Klassen werden angewendet (wenn Tailwind aktiviert ist).
Bei Fehler: Wenn Tailwind-Klassen nicht angewendet werden, tailwind.config.ts überprüfen — content-Array muss ./src/**/*.{ts,tsx} enthalten.
Umgebungsvariablen-Dateien für verschiedene Umgebungen erstellen.
# .env.local — lokale Entwicklung (git-ignoriert)
NEXT_PUBLIC_API_URL=http://localhost:3001
# .env.example — Template (ins Repository einchecken)
NEXT_PUBLIC_API_URL=https://api.example.com
.gitignore aktualisieren:
# Umgebungsvariablen
.env.local
.env.*.local
Next.js-Konventionen für Umgebungsvariablen:
NEXT_PUBLIC_* — im Browser zugänglichErwartet: .env.local existiert (git-ignoriert). .env.example ist eingecheckt als Dokumentation.
Bei Fehler: Wenn Variablen im Browser undefiniert sind, sicherstellen, dass sie mit NEXT_PUBLIC_ beginnen und der Entwicklungsserver neu gestartet wurde.
Den Entwicklungsserver starten und prüfen, ob er läuft.
cd my-app
npm run dev
Erwartete Ausgabe:
▲ Next.js 14.x.x
- Local: http://localhost:3000
- Environments: .env.local
✓ Ready in Xms
# In einem separaten Terminal verifizieren
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000
# Erwartet: 200
Erwartet: Server startet auf Port 3000. HTTP 200 auf Startseite. Keine Kompilierungsfehler.
Bei Fehler: Wenn Port 3000 belegt ist, mit npm run dev -- --port 3001 starten. Wenn TypeScript-Fehler auftreten, tsconfig.json überprüfen — strict: true erfordert explizite Typen überall.
Zusätzliche Routen erstellen, um das App-Router-System zu verifizieren.
// src/app/about/page.tsx
export default function About() {
return (
<main className="p-24">
<h1 className="text-4xl font-bold">About</h1>
<p className="mt-4">About page content here.</p>
</main>
)
}
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000/about
# Erwartet: 200
Erwartet: /about-Route gibt HTTP 200 zurück und rendert Seiteninhalt.
Bei Fehler: Wenn 404 erscheint, sicherstellen, dass die Datei unter src/app/about/page.tsx (nicht src/app/about.tsx) liegt — App Router erfordert page.tsx in Verzeichnissen.
src/app/layout.tsx mit Root-Layout-Komponente vorhandensrc/app/page.tsx ohne TypeScript-Fehler.env.example) ins Repository eingechecktpage.tsx funktionierenpage.tsx; Pages Router verwendet pages/-Verzeichnis direkt. Nicht mischen.'use client' am Anfang der Datei hinzufügen.NEXT_PUBLIC_-Präfix: Ohne dieses Präfix sind Umgebungsvariablen auf dem Server undefiniert, wenn clientseitig zugegriffen wird.@/* wird auf src/ aufgelöst. @/components/Button importiert aus src/components/Button.tsx./About und /about sind identisch in production, aber nicht in development auf case-sensitiven Dateisystemen.next/font optimiert automatisch Fonts. Direkte <link>-Tags für Google Fonts vermeiden.setup-tailwind-typescript — Tailwind CSS + TypeScript in einem Next.js-Projekt konfigurierendeploy-to-vercel — Next.js-Apps auf Vercel deployenuse-graphql-api — GraphQL-API in Next.js-Apps integrierentesting
Launch all available agents in parallel waves for open-ended hypothesis generation on problems where the correct domain is unknown. Use when facing a cross-domain problem with no clear starting point, when single-agent approaches have stalled, or when diverse perspectives are more valuable than deep expertise. Produces a ranked hypothesis set with convergence analysis and adversarial refinement.
tools
Write integration tests for a Node.js CLI application using the built-in node:test module. Covers the exec helper pattern, output assertions, filesystem state verification, cleanup hooks, JSON output parsing, error case testing, and state restoration after destructive tests. Use when adding tests to an existing CLI, testing a new command, verifying adapter behavior across frameworks, or setting up CI for a CLI tool.
development
Screen a proposed trademark for conflicts and distinctiveness before filing. Covers trademark database searches (TMview, WIPO Global Brand Database, USPTO TESS), distinctiveness analysis using the Abercrombie spectrum, likelihood of confusion assessment using DuPont factors and EUIPO relative grounds, common law rights evaluation, and goods/services overlap analysis. Produces a conflict report with a risk matrix. Use before adopting a new brand name, logo, or slogan — distinct from patent prior art search, which uses different databases, legal frameworks, and analysis methods.
tools
Scaffold a new CLI command using Commander.js with options, action handler, three output modes (human-readable, quiet, JSON), and optional ceremony variant. Covers command naming, option design, shared context patterns, error handling, and integration testing. Use when adding a command to an existing Commander.js CLI, designing a new CLI tool from scratch, or standardizing command structure across a multi-command CLI.