james-portfolio

Guides development of a Next.js portfolio site using Pages Router, TypeScript, and Emotion.

Updated May 19, 2026
One-click install
npx skills add https://github.com/theGobindSingh/james-portfolio --skill james-portfolio-thegobindsingh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: james-portfolio
Source: https://github.com/theGobindSingh/james-portfolio
Command: npx skills add https://github.com/theGobindSingh/james-portfolio --skill james-portfolio-thegobindsingh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It gives an AI coding agent the project-specific conventions, architecture boundaries, and workflow rules needed to make consistent changes to a Next.js portfolio codebase without introducing conflicting patterns. ## Core Features & Use Cases - Architecture Guidance: Enforces the Pages Router structure with thin route files in src/pages, composition logic in src/modules, and reusable UI in src/components. - Styling Conventions: Directs all styling through Emotion with theme tokens (--color-, --fs-, --font-*) and mediaQuery helpers instead of hardcoded values or Tailwind. - Use Case: When asked to add a new homepage section, the agent creates a module under src/modules/home with co-located styles.ts, wires it into the home composition, and keeps docs synchronized. ## Quick Start Ask the agent to add a new section to the portfolio homepage following the project's Emotion and module conventions.

Frequently Asked Questions about james-portfolio

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

FAQPage Schema
How do I add a new section to a Next.js Pages Router homepage?

Create a module folder under src/modules/home with index.tsx for render logic and styles.ts for Emotion styles, then mount it in src/modules/home/index.tsx. Use theme variables and mediaQuery helpers for responsive behavior.

How to style React components with Emotion in Next.js?

Use css or styled from @emotion/react and @emotion/styled in co-located styles.ts files. Set jsxImportSource to @emotion/react in tsconfig and consume theme CSS variables like --color-text-900 instead of hardcoded values.

Does this project support the Next.js App Router?

No, the repository uses Pages Router exclusively with src/pages, getStaticPaths, and getStaticProps. App Router patterns like the app directory and generateStaticParams are explicitly disallowed.

Why does pnpm build modify my source files?

The build script runs prebuild, which executes pnpm lint:fix. Both lint scripts run Prettier in write mode before ESLint, so files are reformatted automatically during the build process.

Can I use Tailwind classes in this Next.js project?

No, the project uses Emotion exclusively for styling. Tailwind classes should not be introduced unless the entire styling stack is intentionally migrated.