Agent skill

Opinionated Nextjs Patterns

by pproenca in pproenca/dot-skills

Opinionated, backend-agnostic Next.js 16 (App Router) architecture — authorization at the data layer, server-side loading with cache()+Promise.all, mutations through next-safe-action + typed route…

MITAuto-check passedDevelopment

Install Opinionated Nextjs Patterns

skills CLI
$ npx skills add pproenca/dot-skills --skill opinionated-nextjs-patterns -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pproenca/dot-skills opinionated-nextjs-patterns --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/opinionated-nextjs-patterns .claude/skills/opinionated-nextjs-patterns && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
opinionated-nextjs-patterns
GitHub stars
214
Token cost
~3k tokens
SKILL.md length
921 words
Files
55 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

Opinionated, backend-agnostic Next.js 16 (App Router) architecture — authorization at the data layer, server-side loading with cache()+Promise.all, mutations through next-safe-action + typed route…

  • Works in 8 steps: Authorization & Data-Layer Access… → Multi-Tenancy (CRITICAL — optional, SaaS… → Request Boundary: Proxy (HIGH) → …
  • Refactoring Next.js 16 code
  • SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Opinionated Nextjs Patterns is an agent skill from pproenca/dot-skills. Opinionated, backend-agnostic Next.js 16 (App Router) architecture — authorization at the data layer, server-side loading with cache()+Promise.all, mutations through next-safe-action + typed route handlers, client/server boundaries ('use client' at leaves + TanStack Query), forms with RHF + Zod, UI via shadcn/ui + Tailwind + Base UI + next-intl, request handling in proxy.ts (Next.js 16's renamed middleware), and a Turbo monorepo of @app/ packages confining the backend behind one data-access package. Examples use…

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 57 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).

It sits in Development, covering Forms and validation, Monorepo tooling and Backend development. It works with Next.js, TanStack, Zod and Supabase. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Refactoring Next.js 16 code
  • RSC vs use client placement
  • Monorepo package layout — even when the user doesnt say patterns

Example prompts

  • “use client”
  • “t say”
  • “best practices”
  • “/opinionated-nextjs-patterns”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Authorization & Data-Layer Access (CRITICAL)
  2. Multi-Tenancy (CRITICAL — optional, SaaS only)
  3. Request Boundary: Proxy (HIGH)
  4. Server-Side Data Loading (HIGH)
  5. Mutations: Actions & Route Handlers (HIGH)
  6. Client/Server Boundaries (MEDIUM-HIGH)
  7. Architecture & Services (MEDIUM)
  8. Forms & UI Conventions (MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Opinionated Nextjs Patterns loads about 3k tokens when it runs, and up to ~59k if it reads all its reference files. Until then it costs about 217 tokens; SKILL.md has 921 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~217
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~59k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 921 words, ~3,037 tokens.

Download SKILL.mdSave it as .claude/skills/opinionated-nextjs-patterns/SKILL.md (or your agent's skills folder). This skill also uses 54 other files; get the full folder from GitHub.
name
opinionated-nextjs-patterns
description
Opinionated, backend-agnostic Next.js 16 (App Router) architecture — authorization at the data layer, server-side loading with cache()+Promise.all, mutations through next-safe-action + typed route handlers, client/server boundaries ('use client' at leaves + TanStack Query), forms with RHF + Zod, UI via shadcn/ui + Tailwind + Base UI + next-intl, request handling in proxy.ts (Next.js 16's renamed middleware), and a Turbo monorepo of @app/* packages confining the backend behind one data-access package. Examples use Supabase but every rule states the transferable principle. Use when writing, reviewing, or refactoring Next.js 16 code. Trigger on server actions, route handlers, RSC vs 'use client' placement, TanStack Query, RHF/Zod, proxy.ts, or monorepo package layout — even when the user doesn't say 'patterns' or 'best practices'.

Opinionated Next.js 16 Patterns

Implementation-pattern reference for Next.js 16 (App Router) codebases that want a single, opinionated architecture. Contains 50 rules across 8 categories, prioritised by execution-lifecycle cascade impact — authorization and (optional) tenant modeling first, then the request boundary, server fetching, mutations, client boundaries, architecture, and UI conventions.

The rules are backend-agnostic in principle but use Supabase as the concrete example. Each rule teaches the transferable idea (e.g. "authorize at the data layer", "read through a typed repository"); where the backend genuinely matters, a *Transferable:* note explains the pattern for other stores (Drizzle, Prisma). The structure is a Turbo monorepo with @app/* packages you own — built on canonical libraries (next-safe-action, @supabase/ssr, @tanstack/react-query, react-hook-form + zod, shadcn/ui, next-intl, pino), not a vendored starter kit.

When to Apply

Reach for these rules when:

  • Writing new code — pages, layouts, server actions, route handlers, proxy.ts, feature packages, client components, hooks, the data-access package, SQL/migrations, forms.
  • Reviewing a PR — authorization slips (privileged client without a guard, missing 'server-only'), waterfalls (sequential awaits, client-fetching server data), drift (hand-edited generated types, deep package imports, hardcoded i18n strings).
  • Refactoring — moving code between apps/web and packages/*, splitting actions and services, lifting 'use client' boundaries, replacing raw queries with a typed data-access factory, swapping a backend behind the data-access package.
  • Designing a feature — choosing the right client (request-scoped vs privileged vs browser), deciding action vs route handler, planning the form/server-action contract, scoping a tenant (if multi-tenant).
  • Onboarding — understanding why the codebase looks the way it does, with concrete, transferable examples.

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Authorization & Data-Layer AccessCRITICALauth-
2Multi-Tenancy (optional, SaaS only)CRITICALtenant-
3Request Boundary (Proxy)HIGHproxy-
4Server-Side Data LoadingHIGHserver-
5Mutations: Actions & Route HandlersHIGHmutate-
6Client/Server BoundariesMEDIUM-HIGHclient-
7Architecture & ServicesMEDIUMarch-
8Forms & UI ConventionsMEDIUMui-

Quick Reference

1. Authorization & Data-Layer Access (CRITICAL)
2. Multi-Tenancy (CRITICAL — optional, SaaS only)
3. Request Boundary: Proxy (HIGH)
4. Server-Side Data Loading (HIGH)
Show full SKILL.md (369 more words)Show less
5. Mutations: Actions & Route Handlers (HIGH)
6. Client/Server Boundaries (MEDIUM-HIGH)
7. Architecture & Services (MEDIUM)
8. Forms & UI Conventions (MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and ordering by lifecycle impact
assets/templates/_template.mdTemplate for adding new rules
metadata.jsonVersion, organization, references
  • base-ui-migrator — bulk-migrate Radix asChild patterns to Base UI render props.
  • tailwind-refactor — refactor hardcoded colors to semantic tokens.
  • react-optimise — performance optimisations for React components.
  • nextjs-bundle-optimizer — bundle analysis and reduction for Next.js apps.

© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 54 other files (references, assets) in skills/.experimental/opinionated-nextjs-patterns of pproenca/dot-skills.

  • SKILL.md
  • AGENTS.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/arch-app-vs-packages-boundary.md
  • references/arch-config-driven-navigation.md
  • references/arch-data-access-adapter.md
  • references/arch-feature-package-layout.md
  • references/arch-import-via-package-exports.md
  • references/arch-policy-engine-for-business-rules.md
  • references/arch-provider-gateway-pattern.md
  • references/auth-gate-admin-client.md
  • references/auth-mfa-in-middleware.md
  • references/auth-server-only-imports.md
  • references/auth-trust-rls-no-duplicate-checks.md
  • references/auth-use-require-user.md
  • references/auth-use-sql-policy-helpers.md
  • … and 37 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

Opinionated Nextjs Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Opinionated Nextjs Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Opinionated Nextjs Patterns this skillpproenca/dot-skills214—~3kAutomated safety check: PassMIT
Buzzformbuildnbuzz/buzzform101—~1.5kAutomated safety check: PassMIT
Frontend Developmentavibebuilder/claude-prime120—~1.3kAutomated safety check: PassMIT
Documentation LookupKaimingWan/oh-my-kiro107—~616Automated safety check: PassMIT
Web Frontendlatitude-dev/latitude-llm4.7k—~5.2kAutomated safety check: PassMIT
Shadcn UIjh941213/my-cc-harness1264 repos~9.7kAutomated safety check: NotesMIT

Similar skills

  • Buzzform

    buildnbuzz/buzzform

    A skill your agent uses when working with BuzzForm schema-driven forms, @buildnbuzz/form-core, @buildnbuzz/form-react, or any related APIs like defineSchema, InferType, FormProvider, useDataField…

    101 GitHub stars~1.5k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Frontend Development

    avibebuilder/claude-prime

    A skill your agent uses for ANY work involving React, Next.js, TypeScript, or Tailwind in the browser layer.

    120 GitHub stars~1.3k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Documentation Lookup

    KaimingWan/oh-my-kiro

    Fetch current library/framework documentation via Context7. An agent skill from KaimingWan/oh-my-kiro.

    107 GitHub stars~616 tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed
  • Web Frontend

    latitude-dev/latitude-llm

    apps/web UI — routes, @repo/ui, TanStack Start server functions and collections, navigation (Link vs useNavigate), forms (useForm + createFormSubmitHandler + fieldErrorsAsStrings for Zod field…

    4.7k GitHub stars~5.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Shadcn UI

    jh941213/my-cc-harness

    Complete shadcn/ui component library guide including installation, configuration, and implementation of accessible React components.

    126 GitHub starsUsed in 4 repos~9.7k tokens
    Frontend & DesignAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Opinionated Nextjs Patterns

What does Opinionated Nextjs Patterns do?

Opinionated, backend-agnostic Next.js 16 (App Router) architecture — authorization at the data layer, server-side loading with cache()+Promise.all, mutations through next-safe-action + typed route…. Opinionated Nextjs Patterns is an agent skill from pproenca/dot-skills.js 16's renamed middleware), and a Turbo monorepo of @app/ packages confining the backend behind one data-access package.

When should I use Opinionated Nextjs Patterns?

Opinionated Nextjs Patterns fits situations like: refactoring Next.js 16 code; RSC vs use client placement; monorepo package layout — even when the user doesnt say patterns.

How do I install Opinionated Nextjs Patterns in Claude Code?

Run `npx skills add pproenca/dot-skills --skill opinionated-nextjs-patterns -a claude-code`. Or copy the skill folder (skills/.experimental/opinionated-nextjs-patterns in pproenca/dot-skills) into .claude/skills/opinionated-nextjs-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Opinionated Nextjs Patterns in Codex?

Run `npx skills add pproenca/dot-skills --skill opinionated-nextjs-patterns -a codex`. Or copy the skill folder (skills/.experimental/opinionated-nextjs-patterns in pproenca/dot-skills) into .agents/skills/opinionated-nextjs-patterns in your project. Codex loads it when a task matches its description.

Can I use Opinionated Nextjs Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill opinionated-nextjs-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/opinionated-nextjs-patterns, .gemini/skills/opinionated-nextjs-patterns, .github/skills/opinionated-nextjs-patterns and .opencode/skills/opinionated-nextjs-patterns in your project.

What does Opinionated Nextjs Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Opinionated Nextjs Patterns is instructions for the agent only.

Does Opinionated Nextjs Patterns access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Opinionated Nextjs Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Opinionated Nextjs Patterns use?

Opinionated Nextjs Patterns is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Opinionated Nextjs Patterns use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 56k tokens, read only when the agent opens those files.

What are the alternatives to Opinionated Nextjs Patterns?

Skills that share tags, products or a category with Opinionated Nextjs Patterns: Buzzform (buildnbuzz/buzzform, 101 stars), Frontend Development (avibebuilder/claude-prime, 120 stars), Documentation Lookup (KaimingWan/oh-my-kiro, 107 stars) and Web Frontend (latitude-dev/latitude-llm, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Opinionated Nextjs Patterns?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.