One-click install
npx skills add https://github.com/patricio0312rev/skills --skill repo-structure-linter-patricio0312rev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-structure-linter
Source: https://github.com/patricio0312rev/skills/tree/main/foundation/repo-structure-linter
Command: npx skills add https://github.com/patricio0312rev/skills --skill repo-structure-linter-patricio0312rev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Inconsistent project structures across teams and frameworks create onboarding friction, increase maintenance costs, and lead to avoidable architectural anti-patterns that slow down development.

Core Features & Use Cases

  • Multi-framework validation: Checks project structure against predefined best practices for Next.js, NestJS, Python packages, and React component libraries.
  • Naming convention enforcement: Validates that files, directories, and modules follow framework-standard naming rules.
  • Anti-pattern detection: Flags common structural mistakes like misplaced business logic or unorganized utility files.
  • Use Case: An engineering manager can use this skill to audit a new team's project setup to ensure it aligns with company standards before project kickoff.

Quick Start

Use the repo-structure-linter skill to validate the structure of the attached Next.js project against standard app router conventions.

Frequently Asked Questions about repo-structure-linter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate project structure against framework best practices?

To validate project structure, you audit your directory layout against predefined industry best practices for specific web and backend frameworks, enforcing consistent file organization and naming standards to reduce onboarding friction and prevent architectural drift.

Can I check Next.js app router directory structure for convention violations?

Yes, you can check Next.js app router directory structures for convention violations. The validation process flags common structural anti-patterns and misplaced business logic by comparing your file organization against standard Next.js conventions.

What is project structure anti-pattern detection and why does it matter?

Project structure anti-pattern detection identifies structural mistakes like misplaced business logic or unorganized utility files. It matters because inconsistent structures create onboarding friction, increase maintenance costs, and slow down development across teams.

Does this project structure validation work with NestJS and Python packages?

Yes, project structure validation works with NestJS and Python packages. It also supports React component libraries, applying framework-specific naming rules and file organization standards to ensure consistent directory structures across multiple web and backend frameworks.

How do I enforce naming conventions for files and directories in a React component library?

You enforce naming conventions by validating that files, directories, and modules follow framework-standard naming rules. This checks your React component library against predefined structural best practices to ensure consistent file organization and reduce architectural drift.

What's the best way to audit a new team's project setup before kickoff?

The best way to audit a new team's project setup is to validate the directory structure against framework-specific industry best practices. This identifies structural anti-patterns and convention violations early, ensuring alignment with company standards before project kickoff.