Senior Frontend
Frontend development patterns, performance optimization, and automation tools for React/Next.js applications. Scaffold projects, generate components and hooks, analyze bundle sizes, and apply React/Next.js patterns with accessibility and testing built in.
Core Capabilities
- Project scaffolding — generate Next.js 14+ (App Router) or React+Vite projects with TypeScript, Tailwind, and optional auth/api/forms/testing/storybook features.
- Component generation — client/server components, custom hooks, with test and Storybook story files following established patterns.
- Bundle analysis — static
package.json + import scanning that scores bundle health and flags heavy dependencies with lighter alternatives.
- React patterns — compound components, custom hooks, render props, and reusable state-sharing patterns.
- Next.js optimization — Server vs Client Components, image optimization, parallel/streaming data fetching with Suspense.
- Accessibility & testing — semantic HTML, ARIA, keyboard nav, focus, and React Testing Library component/a11y tests.
When to Use
- Starting a new React/Next.js project that needs a best-practice baseline.
- Adding components, hooks, or test/story scaffolding to an existing app.
- Optimizing bundle size or diagnosing heavy dependencies.
- Implementing accessible, performant Server/Client Component architecture.
- Reviewing frontend code against React/TypeScript/a11y best practices.
Clarify First
Before scaffolding or generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Tools
| Tool |
Purpose |
Command |
frontend_scaffolder.py |
Scaffold a Next.js or React project with TypeScript + Tailwind + optional features |
python scripts/frontend_scaffolder.py my-app --template nextjs --features auth,api |
component_generator.py |
Generate a component/hook with optional test and Storybook story |
python scripts/component_generator.py ProductCard --type client --with-test --with-story |
bundle_analyzer.py |
Score bundle health and flag heavy dependencies from package.json + imports |
python scripts/bundle_analyzer.py /path/to/project --verbose |
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/tooling-guide.md — full scaffolding / component-generation / bundle-analysis workflows, option tables, generated structure, the per-script flag reference, troubleshooting table, and success criteria. Read when running a tool or wiring up CLI flags.
- references/code-patterns.md — inline React patterns (compound components, hooks, render props), Next.js optimization (Server/Client, image, data fetching), accessibility + testing snippets, and the Next.js config / Tailwind / TypeScript quick reference. Read when writing components or optimizing pages.
- references/react_patterns.md — deep React patterns library. Read when designing component/state architecture.
- references/nextjs_optimization_guide.md — deep Next.js performance and rendering guide. Read when tuning Next.js apps.
- references/frontend_best_practices.md — accessibility, testing, and general frontend best-practice guide. Read before shipping a component.
Scope & Limitations
What this skill covers:
- React and Next.js project scaffolding with TypeScript and Tailwind CSS
- Component, hook, test, and Storybook story generation following established patterns
- Static bundle analysis based on
package.json dependency inspection and import pattern scanning
- Frontend-specific best practices for Server Components, image optimization, data fetching, and accessibility
What this skill does NOT cover:
- Backend API development, database schema design, or server infrastructure -- see senior-backend and senior-fullstack
- End-to-end testing with Cypress or Playwright -- see senior-qa
- CI/CD pipeline configuration and Docker deployment -- see senior-devops
- Security vulnerability scanning and penetration testing -- see senior-secops and senior-security
Integration Points
| Skill |
Integration |
Data Flow |
| senior-fullstack |
Scaffolded frontend projects connect to fullstack project scaffolder for API layer setup |
Frontend project structure feeds into project_scaffolder.py which adds backend, Docker, and CI/CD layers |
| senior-backend |
Components consuming API data follow patterns defined by backend skill's REST/GraphQL conventions |
Backend API response types imported into frontend types/ directory generated by this skill |
| senior-qa |
Generated test files (--with-test) use the same Testing Library conventions that the QA skill's test strategies build upon |
Component test files hand off to QA skill for integration and E2E test coverage expansion |
| senior-devops |
Bundle analyzer output informs build pipeline optimization decisions |
Bundle health score and dependency warnings feed into CI quality gates configured by DevOps skill |
| senior-secops |
Dependency analysis identifies packages that need security audit |
Heavy/outdated dependency warnings from bundle_analyzer.py trigger security review workflows |
| code-reviewer |
Generated components follow patterns that the code reviewer skill validates |
Code reviewer checks generated components against React/TypeScript best practices defined in this skill's references |
1---2name: senior-frontend3description: Frontend development for React, Next.js, TypeScript, and Tailwind CSS. Use when building React components, optimizing Next.js performance, analyzing bundle sizes, scaffolding projects, implementing accessibility, or reviewing frontend code.4license: MIT + Commons Clause5---6# Senior Frontend
7
8Frontend development patterns, performance optimization, and automation tools for React/Next.js applications. Scaffold projects, generate components and hooks, analyze bundle sizes, and apply React/Next.js patterns with accessibility and testing built in.
9
10## Core Capabilities
11
12- **Project scaffolding** — generate Next.js 14+ (App Router) or React+Vite projects with TypeScript, Tailwind, and optional auth/api/forms/testing/storybook features.
13- **Component generation** — client/server components, custom hooks, with test and Storybook story files following established patterns.
14- **Bundle analysis** — static `package.json` + import scanning that scores bundle health and flags heavy dependencies with lighter alternatives.
15- **React patterns** — compound components, custom hooks, render props, and reusable state-sharing patterns.
16- **Next.js optimization** — Server vs Client Components, image optimization, parallel/streaming data fetching with Suspense.
17- **Accessibility & testing** — semantic HTML, ARIA, keyboard nav, focus, and React Testing Library component/a11y tests.
18
19## When to Use
20
21- Starting a new React/Next.js project that needs a best-practice baseline.
22- Adding components, hooks, or test/story scaffolding to an existing app.
23- Optimizing bundle size or diagnosing heavy dependencies.
24- Implementing accessible, performant Server/Client Component architecture.
25- Reviewing frontend code against React/TypeScript/a11y best practices.
26
27## Clarify First
28
29Before scaffolding or generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:
30
31- [ ] **Template** — Next.js (App Router) vs React+Vite (`--template`; produces a different project structure)
32- [ ] **Features** — auth / api / forms / testing / storybook (`--features`; decides what gets generated)
33- [ ] **Generation target** — a new project vs a component/hook in an existing app (selects `frontend_scaffolder` vs `component_generator`)
34
35Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
36
37## Tools
38
39| Tool | Purpose | Command |
40|------|---------|---------|
41| `frontend_scaffolder.py` | Scaffold a Next.js or React project with TypeScript + Tailwind + optional features | `python scripts/frontend_scaffolder.py my-app --template nextjs --features auth,api` |
42| `component_generator.py` | Generate a component/hook with optional test and Storybook story | `python scripts/component_generator.py ProductCard --type client --with-test --with-story` |
43| `bundle_analyzer.py` | Score bundle health and flag heavy dependencies from `package.json` + imports | `python scripts/bundle_analyzer.py /path/to/project --verbose` |
44
45## References
46
47Load the reference that matches the task — keep this file lean and pull detail on demand:
48
49- **[references/tooling-guide.md](references/tooling-guide.md)** — full scaffolding / component-generation / bundle-analysis workflows, option tables, generated structure, the per-script flag reference, troubleshooting table, and success criteria. Read when running a tool or wiring up CLI flags.
50- **[references/code-patterns.md](references/code-patterns.md)** — inline React patterns (compound components, hooks, render props), Next.js optimization (Server/Client, image, data fetching), accessibility + testing snippets, and the Next.js config / Tailwind / TypeScript quick reference. Read when writing components or optimizing pages.
51- **[references/react_patterns.md](references/react_patterns.md)** — deep React patterns library. Read when designing component/state architecture.
52- **[references/nextjs_optimization_guide.md](references/nextjs_optimization_guide.md)** — deep Next.js performance and rendering guide. Read when tuning Next.js apps.
53- **[references/frontend_best_practices.md](references/frontend_best_practices.md)** — accessibility, testing, and general frontend best-practice guide. Read before shipping a component.
54
55## Scope & Limitations
56
57**What this skill covers:**
58- React and Next.js project scaffolding with TypeScript and Tailwind CSS
59- Component, hook, test, and Storybook story generation following established patterns
60- Static bundle analysis based on `package.json` dependency inspection and import pattern scanning
61- Frontend-specific best practices for Server Components, image optimization, data fetching, and accessibility
62
63**What this skill does NOT cover:**
64- Backend API development, database schema design, or server infrastructure -- see **senior-backend** and **senior-fullstack**
65- End-to-end testing with Cypress or Playwright -- see **senior-qa**
66- CI/CD pipeline configuration and Docker deployment -- see **senior-devops**
67- Security vulnerability scanning and penetration testing -- see **senior-secops** and **senior-security**
68
69## Integration Points
70
71| Skill | Integration | Data Flow |
72|-------|-------------|-----------|
73| **senior-fullstack** | Scaffolded frontend projects connect to fullstack project scaffolder for API layer setup | Frontend project structure feeds into `project_scaffolder.py` which adds backend, Docker, and CI/CD layers |
74| **senior-backend** | Components consuming API data follow patterns defined by backend skill's REST/GraphQL conventions | Backend API response types imported into frontend `types/` directory generated by this skill |
75| **senior-qa** | Generated test files (`--with-test`) use the same Testing Library conventions that the QA skill's test strategies build upon | Component test files hand off to QA skill for integration and E2E test coverage expansion |
76| **senior-devops** | Bundle analyzer output informs build pipeline optimization decisions | Bundle health score and dependency warnings feed into CI quality gates configured by DevOps skill |
77| **senior-secops** | Dependency analysis identifies packages that need security audit | Heavy/outdated dependency warnings from `bundle_analyzer.py` trigger security review workflows |
78| **code-reviewer** | Generated components follow patterns that the code reviewer skill validates | Code reviewer checks generated components against React/TypeScript best practices defined in this skill's references |