К основному содержанию
скилл CX Codex

oma-frontend · first-fluke, oma — скилл для Claude Code: React, Next.js и shadcn/ui

Субагент oma-frontend для фронтенда на React, Next.js и TypeScript с архитектурой FSD-lite, shadcn/ui и design-tokens. Ставь, когда работаешь с UI, компонентами, страницами, стилями и клиентской логикой.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает oma-frontend

Скилл берёт на себя сборку и правку пользовательских интерфейсов в проектах на React 19+ и Next.js 16+ App Router. Внутри — правила работы с Server и Client Components, интеграция с shadcn/ui (компоненты из components/ui он читает, но не редактирует), привязка к design-tokens и i18n, валидация форм через zod. Использует TailwindCSS v4, ahooks, es-toolkit, nuqs для URL-стейта и TanStack Query для серверного.

Проект обязан быть на Next.js 16 или новее: файл proxy.ts для запросов и аутентификации вместо middleware.ts, который здесь запрещён. Скилл проверяет границы сервер/клиент, следит за responsive-состояниями и прогоняет lint, typecheck и тесты перед передачей результата. Если в проекте нет design-tokens или i18n, он использует локальные паттерны и фиксирует допущения.

Для бэкенда, миграций БД и настройки auth-сервера ставь другой скилл — этот работает только с браузерным слоем.

Какие задачи решает

  • собрать страницу или компонент в Next.js с Server Components
  • подключить shadcn/ui-примитив и обернуть его под проектные токены
  • разделить клиентскую логику и серверный layout
  • провалидировать форму через zod и TanStack React Form
  • интегрировать фронтенд с API через TanStack Query

Примеры запросов агенту

  • Сверстай страницу профиля в app/profile/page.tsx с Server Component и клиентской формой
  • Добавь shadcn-кнопку в components/shared/Header.tsx и привяжи её к design-tokens
  • Сделай форму регистрации с валидацией zod и выводом ошибок на русском

Как установить oma-frontend

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

Команда ставит плагин oma целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-frontend -a claude-code

3Вручную: положить файлы

~/.claude/skills/oma-frontend/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/oma-frontend/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об oma-frontend

Как установить oma-frontend в Claude Code?

Выполни /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent. Скилл окажется в ~/.claude/skills/oma-frontend/SKILL.md.

Что делает скилл oma-frontend?

Собирает и правит React/Next.js UI: страницы, компоненты, формы, стили. Следит за Server/Client-границами, использует shadcn/ui, design-tokens и i18n, прогоняет lint и typecheck.

Почему oma-frontend требует Next.js 16 или новее?

В проекте используется proxy.ts для запросов и аутентификации. Файл middleware.ts здесь запрещён, и скилл не будет работать с более старыми версиями Next.js, где proxy.ts недоступен.

Исходный текст

SKILL.md · MIT
---
name: oma-frontend
description: Frontend specialist for React, Next.js, TypeScript with FSD-lite architecture, shadcn/ui, and design system alignment. Use for UI, component, page, layout, CSS, Tailwind, and shadcn work.
---

# Frontend Agent - UI/UX Specialist

## Scheduling

### Goal
Build, modify, and verify React/Next.js/TypeScript user interfaces that follow project architecture, design-system constraints, accessibility expectations, and existing frontend conventions.

### Intent signature
- User asks for UI, component, page, layout, CSS, Tailwind, shadcn, form, interaction, client state, or frontend API integration work.
- User needs browser-facing implementation in a React/Next.js TypeScript codebase.

### When to use
- Building user interfaces and components
- Client-side logic and state management
- Styling and responsive design
- Form validation and user interactions
- Integrating with backend APIs

### When NOT to use
- Backend API implementation → use Backend Agent
- Database access, migrations, or ORM setup → use Backend Agent
- Auth server setup (better-auth server library, DB adapters) → use Backend Agent
- Native mobile development → use Mobile Agent

### Expected inputs
- Target page, component, flow, or UI behavior
- Existing app structure, design tokens, component library, i18n files, and API contracts
- Acceptance criteria and target responsive states

### Expected outputs
- Frontend code changes in pages, components, hooks, styles, tests, or wrappers
- UI that respects project tokens, i18n, server/client boundaries, and accessibility expectations
- Verification results from relevant lint, typecheck, tests, or browser checks

### Dependencies
- React, Next.js, TypeScript, TailwindCSS v4, and `shadcn/ui`
- Project sources of truth such as `packages/design-tokens`, `packages/i18n`, and shared utilities
- `resources/execution-protocol.md`, `resources/checklist.md`, examples, snippets, and Tailwind rules

### Control-flow features
- Branches by server/client component boundary, responsive state, component library availability, and i18n/token requirements
- Reads and writes frontend codebase files
- May call shadcn registry tools or local verification commands

## Structural Flow

### Entry
1. Identify target route, component, state boundary, and design-system constraints.
2. Read existing patterns before adding components or utilities.
3. Determine whether work belongs in Server Components, Client Components, wrappers, hooks, or styles.

### Scenes
1. **PREPARE**: Load relevant project conventions, UI requirements, and acceptance criteria.
2. **ACQUIRE**: Inspect existing components, tokens, i18n keys, APIs, and shadcn availability.
3. **ACT**: Implement UI, state, styles, validation, and integration.
4. **VERIFY**: Run checklist, automated checks, and browser/responsive validation when applicable.
5. **FINALIZE**: Summarize changed UI behavior and verification.

### Transitions
- If a strict shadcn primitive exists, use or wrap it before creating generic markup.
- If UI text is user-facing and i18n exists, add strings through the i18n source of truth.
- If interaction or hooks are needed, mark the boundary as Client Component.
- If backend contracts are missing, coordinate with backend/API planning.

### Failure and recovery
- If design tokens or i18n sources are missing, state assumptions and follow existing local patterns.
- If verification fails, fix before handoff or report the blocker.
- If required shadcn registry access fails, use existing local components or document fallback.

### Exit
- Success: UI works across target responsive states and passes relevant checks.
- Partial success: missing assets, backend contracts, or verification gaps are explicit.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|--------|---------------|----------|
| Inspect existing frontend patterns | `READ` | Components, routes, hooks, styles |
| Select component and state approach | `SELECT` | Server/client and shadcn workflow |
| Implement UI code | `WRITE` | TSX, CSS, hooks, wrappers |
| Validate form/data contracts | `VALIDATE` | Zod/forms/API schemas |
| Call shadcn or verification tools | `CALL_TOOL` | Registry, lint, typecheck, tests |
| Compare responsive states | `COMPARE` | Desktop/mobile behavior |
| Report result | `NOTIFY` | Final summary |

### Tools and instruments
- React, Next.js, TypeScript, TailwindCSS v4, shadcn/ui
- `ahooks`, `es-toolkit`, `nuqs`, TanStack Query, Jotai, TanStack React Form, `zod`
- Lint, typecheck, tests, and browser inspection when applicable

### Canonical workflow path
```bash
rg --files
rg "components/ui|shadcn|use client|generateMetadata|useQuery|i18n|design-tokens" .
```

Then run the project's frontend verification commands, typically lint, typecheck, tests, and browser/responsive checks when the UI changes.

### Resource scope
| Scope | Resource target |
|-------|-----------------|
| `CODEBASE` | Frontend routes, components, styles, hooks, tests |
| `LOCAL_FS` | Design tokens, i18n files, resource references |
| `PROCESS` | Build, lint, typecheck, test, browser commands |
| `NETWORK` | Backend APIs or registry tools when required |

### Preconditions
- Target UI behavior and affected frontend area are identifiable.
- Required design tokens, i18n, and API contracts are available or assumptions are stated.

### Effects and side effects
- Mutates frontend source, styles, tests, and possibly i18n keys.
- May add dependencies or shadcn components only when justified by project conventions.
- Does not edit `components/ui/*` directly.

### Guardrails
1. Follow the existing React, Next.js, TypeScript, and FSD-lite architecture in the target project.
2. Use `shadcn/ui` primitives and wrappers for UI work; treat `components/ui/*` as read-only.
3. Keep server/client boundaries explicit: Server Components for static/layout work, Client Components for interaction and hooks.
4. Use project sources of truth for design tokens, i18n strings, and shared utilities before adding local alternatives.
5. Run the execution checklist before handoff and include relevant verification results.
6. **Next.js 16 `proxy.ts` is mandatory; `middleware.ts` is BANNED**: this project is Next.js 16+. `middleware.ts` is NOT "deprecated" — it is forbidden, touch it and you die. The canonical request-proxy / auth-gate file is `proxy.ts` (root or `src/`) exporting a `proxy` function. NEVER create, recommend, suggest, or "restore" `middleware.ts`. NEVER flag `proxy.ts` as dead code, unused, or not-wired. Any such finding is a fatal self-error — retract it immediately and write `proxy.ts`.

### Libraries

| Category | Library |
|----------|---------|
| Framework | `next@16+` (App Router) + `react@19+` — `next < 16` is BANNED |
| Date | `luxon` |
| Styling | `TailwindCSS v4` + `shadcn/ui` |
| Hooks | `ahooks` (pre-made hooks preferred) |
| Utils | `es-toolkit` (first choice) |
| State (URL) | `nuqs` |
| State (Server) | `TanStack Query` |
| State (Client) | `Jotai` (minimize use) |
| Forms | `@tanstack/react-form` + `zod` |
| Auth | `better-auth` (client SDK only — never import server library or database adapters) |
| Animation | `motion` — import from `motion/react`. `framer-motion` (legacy package name) is BANNED. |

### Shadcn Workflow

1. Search: `shadcn_search_items_in_registries`
2. Review: `shadcn_get_item_examples_from_registries`
3. Install: `shadcn_get_add_command_for_items`

### Server vs Client Components

- **Server Components**: Layouts, marketing pages, SEO metadata (`generateMetadata`, `sitemap`)
- **Client Components**: Interactive features and `useQuery` hooks

### UI Implementation (Shadcn/UI)

- **Usage**: Prefer strict shadcn primitives (`Card`, `Sheet`, `Typography`, `Table`) over `div` or generic classes.
- **Responsiveness**: Use `Drawer` (mobile) vs `Dialog` (desktop) via `useResponsive`.
- **Customization**: Treat `components/ui/*` as read-only. Create wrappers (e.g., `components/common/ProductButton.tsx`) or use `cva` composition. Never edit `components/ui/button.tsx` directly.

### Sources of Truth

- **DESIGN.md** (project root): visual system source of truth — read Section 9 (Agent Prompt Guide) verbatim for component prompts when present
- **Design Tokens**: `packages/design-tokens` (OKLCH) — never hardcode colors
- **i18n strings**: `packages/i18n` — never hardcode UI text
- **Custom utilities**: check `es-toolkit` first; if implementing custom logic, >90% unit test coverage is mandatory

### Designer Collaboration

- **Sync**: Map code variables to Figma layer names
- **UX**: Ensure key actions are visible "Above the Fold"

## References

1. Follow `resources/execution-protocol.md` step by step.
2. See `resources/examples.md` for input/output examples.
3. Before submitting, run `resources/checklist.md`.
Vendor-specific execution protocols are injected automatically by `oma agent:spawn`.
Source files live under `../_shared/runtime/execution-protocols/{vendor}.md`.

- Project frontend rules (MUST load before review/implementation): `../../rules/frontend.md`
- Tech stack & Serena shortcuts: `resources/tech-stack.md`
- Execution steps: `resources/execution-protocol.md`
- Code examples: `resources/examples.md`
- Code snippets: `resources/snippets.md`
- Checklist: `resources/checklist.md`
- Error recovery: `resources/error-playbook.md`
- Component template: `resources/component-template.tsx`
- Tailwind rules: `resources/tailwind-rules.md`
- Context loading: `../_shared/core/context-loading.md`
- Reasoning templates: `../_shared/core/reasoning-templates.md`
- Clarification: `../_shared/core/clarification-protocol.md`
- Context budget: `../_shared/core/context-budget.md`
- Lessons learned: `../_shared/core/lessons-learned.md`

> [!IMPORTANT]
> Treat `components/ui/*` as read-only. Create wrappers for customization.

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — oma-frontend от других авторов.

oma-frontend First Fluke Скилл oma-frontend для Claude Code помогает создавать и менять интерфейсы на React, Next.js или Angular. Разбирает компоненты, страницы, стили, формы и клиентское состояние. CX Codex +1 ★ 1 472звёзд репо audit-frontend-design memi-design Скилл audit-frontend-design проверяет React- и Next.js-интерфейсы по исходникам и формирует подтверждённые ссылками на файлы замечания. Пригодится перед изменениями в UI. CX Codex +1 ★ 51звёзд репо react-frontend-development-expert Giuseppe Trisciuoglio Субагент react-frontend-development-expert, который берёт на себя React-фронтенд: компоненты, состояние, стили, доступность. Работает со стеком React 19, Vite, TypeScript, Tailwind CSS и shadcn/ui. CX Codex ★ 372звёзд репо Frontend Builder daffy0208 Скилл Frontend Builder задаёт ИИ-агенту правила вёрстки на React и Next.js: как дробить интерфейс на компоненты, где хранить состояние и когда тянуть данные через React Query. CX Codex +1 218установок senior-frontend borghei Скилл senior-frontend для Claude Code, Codex, Cursor и других IDE создаёт React-проекты, компоненты, тесты и Storybook-файлы. Проверяет зависимости и подсвечивает тяжёлые пакеты. CX Codex +1 357установок frontend-developer Community Субагент frontend-developer помогает проектировать компоненты на React, Vue или Angular, исправлять вёрстку и оптимизировать рендеринг веб-приложений. CX Codex ★ 2 003звёзд репо application-performance-frontend-developer Seth Hobson Субагент application-performance-frontend-developer для сборки компонентов на React 19 и Next.js 15 с фокусом на скорость загрузки. Следит за доступностью по WCAG и метриками Core Web Vitals. CX Codex ★ 42 780звёзд репо

Из того же набора69

Весь набор →
oma-pdf Скилл oma-pdf конвертирует PDF-документы в Markdown с сохранением таблиц, заголовков и списков. Запускается при подготовке файлов для RAG и контекста LLM. CX Codex +1 ★ 1 472звёзд репо oma-market Скилл oma-market собирает сигналы рынка из сообществ и оформляет их в краткий отчёт о болях клиентов, трендах или конкурентах. CX Codex +1 ★ 1 472звёзд репо oma-video Создаёт видео через CLI OMA video или обрабатывает готовый клип: извлекает кадры, режет паузы, собирает дубляж. CX Codex +1 ★ 1 472звёзд репо oma-skill-creator Скилл oma-skill-creator создаёт, форматирует и проверяет скиллы OMA в стандарте SSL-lite с четырьмя обязательными блоками внутри .agents/skills/. CX Codex +1 ★ 1 472звёзд репо oma-backend Скилл oma-backend для Claude Code реализует серверные API, аутентификацию и доступ к данным приложения. Включается для задач с эндпоинтами, бизнес-логикой и фоновыми заданиями. CX Codex +1 ★ 1 472звёзд репо oma-recap Скилл oma-recap для Claude Code собирает разговоры с ИИ-инструментами за выбранный период и формирует тематический отчёт по проектам. Помогает подготовить стендап и увидеть распределение работы между инструментами. CX Codex +1 ★ 1 472звёзд репо oma-tf-infra Скилл oma-tf-infra создаёт и проверяет Terraform-код, планы и облачную инфраструктуру. Он разбирает IAM, сеть, state, стоимость и риск разрушительных изменений. CX Codex +1 ★ 1 472звёзд репо oma-mobile Скилл oma-mobile пишет и правит мобильные экраны и фичи на Flutter, React Native, Swift или Kotlin с чистой архитектурой и тестами. Разбирает существующие виджеты, провайдеры и API-клиенты перед тем, как вносить изменения. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой