statick88/dotfiles/nextjs-best-practices
Claude Code and agent skill by statick88/dotfiles
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
Next.js App Router principles. Server Components, data fetching, routing patterns.
Install
npx vskill@latest install statick88/dotfiles/nextjs-best-practicesSKILL.md
The same SKILL.md was published earlier as dicklesworthstone/pi_agent_rust/nextjs-best-practices.
Next.js Best Practices
Principles for Next.js App Router development.
1. Server vs Client Components
Decision Tree
By Default
| Type | Use | |
|---|---|---|
| Server | Data fetching, layout, static content | |
| Client | Forms, buttons, interactive UI |
2. Data Fetching Patterns
Fetch Strategy
| Pattern | Use | |
|---|---|---|
| Default | Static (cached at build) | |
| Revalidate | ISR (time-based refresh) | |
| No-store | Dynamic (every request) |
Data Flow
| Source | Pattern | |
|---|---|---|
| Database | Server Component fetch | |
| API | fetch with caching | |
| User input | Client state + server action |
3. Routing Principles
File Conventions
| File | Purpose | |
|---|---|---|
page.tsx | Route UI | |
layout.tsx | Shared layout | |
loading.tsx | Loading state | |
error.tsx | Error boundary | |
not-found.tsx | 404 page |
Route Organization
| Pattern | Use | |
|---|---|---|
Route groups (name) | Organize without URL | |
Parallel routes @slot | Multiple same-level pages | |
Intercepting (.) | Modal overlays |
4. API Routes
Route Handlers
| Method | Use | |
|---|---|---|
| GET | Read data | |
| POST | Create data | |
| PUT/PATCH | Update data | |
| DELETE | Remove data |
Best Practices
- Validate input with Zod
- Return proper status codes
- Handle errors gracefully
- Use Edge runtime when possible
5. Performance Principles
Image Optimization
- Use next/image component
- Set priority for above-fold
- Provide blur placeholder
- Use responsive sizes
Bundle Optimization
- Dynamic imports for heavy components
- Route-based code splitting (automatic)
- Analyze with bundle analyzer
6. Metadata
Static vs Dynamic
| Type | Use | |
|---|---|---|
| Static export | Fixed metadata | |
| generateMetadata | Dynamic per-route |
Essential Tags
- title (50-60 chars)
- description (150-160 chars)
- Open Graph images
- Canonical URL
7. Caching Strategy
Cache Layers
| Layer | Control | |
|---|---|---|
| Request | fetch options | |
| Data | revalidate/tags | |
| Full route | route config |
Revalidation
| Method | Use | |
|---|---|---|
| Time-based | revalidate: 60 | |
| On-demand | revalidatePath/Tag | |
| No cache | no-store |
8. Server Actions
Use Cases
- Form submissions
- Data mutations
- Revalidation triggers
Best Practices
- Mark with 'use server'
- Validate all inputs
- Return typed responses
- Handle errors
9. Anti-Patterns
| ❌ Don't | ✅ Do | |
|---|---|---|
| 'use client' everywhere | Server by default | |
| Fetch in client components | Fetch in server | |
| Skip loading states | Use loading.tsx | |
| Ignore error boundaries | Use error.tsx | |
| Large client bundles | Dynamic imports |
10. Project Structure
Remember: Server Components are the default for a reason. Start there, add client only when needed.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingamp/.agents/skills/skills/nextjs-best-practices/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/statick88/dotfiles/nextjs-best-practices)