mcpField
F
frontend-ui-integration

frontend-ui-integration

github.com/julianromliDevelopment21054 installsUpdated 2d ago
Repository

About frontend-ui-integration

A workflow skill for implementing user-facing changes in an existing React and TypeScript web app. It focuses on wiring established APIs into the existing design system, routing, state patterns, and tests, while excluding backend or data-model changes.

Key features

  1. 01Integrates existing backend APIs
  2. 02Follows React and TypeScript conventions
  3. 03Handles loading and error states
  4. 04Requires accessible UI behavior
  5. 05Adds unit and integration tests
  6. 06Runs lint, test, and type checks

Use cases

  1. 01Implementing a web feature backed by existing APIs
  2. 02Extending an existing route or component
  3. 03Adding accessible UI states and test coverage
  4. 04Validating a frontend change before completion

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/julianromli/ai-skills --skill frontend-ui-integration

After installing, type/frontend-ui-integrationin Claude Code to confirm it loaded.

Details

From the project README

Skill: Frontend UI integration

Purpose

Implement or extend a user-facing workflow in our primary web application, integrating with existing backend APIs and following our design system, routing, and testing conventions.

When to use this skill

  • The feature is primarily a UI/UX change backed by one or more existing APIs.
  • The backend contracts, auth model, and core business rules already exist.
  • The change affects only the web frontend (no schema or service ownership changes).

Inputs

  • Feature description: short narrative of the user flow and outcomes.
  • Relevant APIs: endpoints, request/response types, and links to source definitions.
  • Target routes/components: paths, component names, or feature modules.
  • Design references: Figma links or existing screens to mirror.
  • Guardrails: performance limits, accessibility requirements, and any security constraints.

Out of scope

  • Creating new backend services or changing persistent data models.
  • Modifying authentication/authorization flows.
  • Introducing new frontend frameworks or design systems.

Conventions

  • Framework: React with TypeScript.
  • Routing: use the existing router and route layout patterns.
  • Styling: use the in-house design system components (Buttons, Inputs, Modals, Toasts, etc.).
  • State management: prefer the existing state libraries (e.g., React Query, Redux, Zustand) and follow established patterns.

Required behavior

  1. Implement the UI changes with strong typing for all props and API responses.
  2. Handle loading, empty, error, and success states using existing primitives.
  3. Ensure the UI is keyboard accessible and screen-reader friendly.
  4. Respect feature flags and rollout mechanisms where applicable.

Required artifacts

  • Updated components and hooks in the appropriate feature module.
  • Unit tests for core presentation logic.
  • Integration or component tests for the new flow (e.g., React Testing Library, Cypress, Playwright) where the repo already uses them.
  • Minimal CHANGELOG or PR description text summarizing the behavior change (to be placed in the PR, not this file).

Implementation checklist

  1. Locate the relevant feature module and existing components.
  2. Confirm the backend APIs and types, updating shared TypeScript types if needed.
  3. Implement the UI, wiring in API calls via the existing data layer.
  4. Add or update tests to cover the new behavior and edge cases.
  5. Run the required validation commands (see below).

Verification

Run the following (adjust commands to match the project):

  • pnpm lint
  • pnpm test -- --runInBand --watch=false
  • pnpm typecheck (if configured separately)

The skill is complete when:

  • All tests, linters, and type checks pass.
  • The new UI behaves as specified across normal, error, and boundary cases.
  • No unrelated files or modules are modified.

Safety and escalation

  • If the requested change requires backend contract changes, stop and request a backend-focused task instead.
  • If design references conflict with existing accessibility standards, favor accessibility and highlight the discrepancy in the PR description.

Comments

Markdown supported