Can I run this on specific parts of my project?

Yes, the skill accepts an optional module argument to target specific directories or can be run against the entire src/modules path by default.

What specifically does the Architecture Validator check?

It runs 18 automated tests covering Next.js directives, service layer patterns, module imports, component size, and framework-specific requirements like metadata and error boundaries.

How are the validation results presented?

The skill generates a detailed log of every check followed by a clean summary table showing the pass/fail status and the number of occurrences for each architectural rule.

Does it require a specific file to work properly?

The skill is designed to validate your project against patterns typically defined in an ARCHITECTURE.md file, ensuring your implementation matches your documentation.

Is it compatible with older Next.js projects?

While it focuses on App Router best practices, it includes specific checks to identify and warn about remnants of the older Pages Router to assist in migrations.

Next.js Architecture Validator

Name: Next.js Architecture Validator
Author: HerbertJulio

byHerbertJulio

•

Security & Testing

Automates architectural conformance checks for Next.js projects to ensure alignment with defined best practices and project structure.

This skill provides an automated suite of 18 specific architectural checks for Next.js applications, validating everything from proper directive usage ('use client'/'use server') to folder structures and state management patterns. It allows developers and teams to instantly audit a module or an entire codebase against an ARCHITECTURE.md standard, identifying issues like missing error boundaries, leaked server state, cross-module import violations, and technical debt artifacts. It is an essential tool for maintaining high code quality and consistency in complex Next.js App Router projects.

Key Features

01Identification of technical debt such as 'any' types, debug artifacts, and oversized components.

02Automated verification of Next.js App Router conventions including directives and metadata.

03Validation of service layer patterns, specifically checking for error handling and data transformations.

04Enforcement of module boundaries to prevent illegal cross-module imports.

05Comprehensive summary reporting with a 18-point pass/fail architectural scorecard.

0610 GitHub stars

Use Cases

01Automating architectural reviews during the Pull Request process for Next.js projects.

02Enforcing consistent coding standards across large, multi-module development teams.

03Auditing legacy Next.js codebases to identify Page Router remnants and modernization needs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertjulio/specialist-agent review-check-architecture

For use in Claude.ai and ChatGPT

Key Features

01Identification of technical debt such as 'any' types, debug artifacts, and oversized components.

02Automated verification of Next.js App Router conventions including directives and metadata.

03Validation of service layer patterns, specifically checking for error handling and data transformations.

04Enforcement of module boundaries to prevent illegal cross-module imports.

05Comprehensive summary reporting with a 18-point pass/fail architectural scorecard.

0610 GitHub stars

Use Cases

01Automating architectural reviews during the Pull Request process for Next.js projects.

02Enforcing consistent coding standards across large, multi-module development teams.

03Auditing legacy Next.js codebases to identify Page Router remnants and modernization needs.