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

frontend-testing-debugging · fcakyon — скилл для Claude Code: отладка вёрстки

Скилл frontend-testing-debugging ведёт агента по циклу визуальной отладки: воспроизвести взаимодействие, посмотреть консоль и вёрстку, поправить причину и перезапустить упавший journey.

Apache-2.0 ★ 1 216 обновлён 2026-11-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install frontend-design-skills@claude-settings
Открыть на GitHub

Что делает frontend-testing-debugging

Скилл ведёт цикл визуальной диагностики. Агент сначала определяет входной маршрут, действие пользователя и ожидаемый видимый результат, читает скрипты репозитория и запущенные серверы, и только потом спрашивает URL. Существующий journey, покрывающий изменение, прогоняется первым.

Дальше работа идёт на инфраструктуре проекта. Если стоит QA-плагин и есть его конфигурация, запуск идёт через qa:run-qa: восстановление сессии, изоляция телеметрии, уборка. Когда покрытия нет, qa:setup его создаёт. Без плагина агент берёт браузерный или e2e-воркфлоу из репозитория, а если и его нет — временный диагностический скрипт вне коммитов. Проверку отрендеренного результата скилл отдаёт установленному ui-regression.

Эталонные скриншоты сравниваются в одинаковом состоянии и вьюпорте, на desktop и mobile, после загрузки медиа. Если текст разъезжается между локалями, агент идёт по цепочке: перевод, форматирование, нормализация Unicode, регистр в JavaScript, CSS — и правит то звено, которое ломает вывод. Сборка прошла, скриншот корневой страницы чистый? Про взаимодействие это ничего не говорит, поэтому упавший шаг повторяют, а затронутые journey перезапускают. За собой скилл закрывает только созданные им табы и preview-серверы.

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

  • отладить вёрстку после правки компонента
  • сверить страницу с эталонным скриншотом в том же вьюпорте
  • проверить консоль и оверлеи фреймворка до разбора вёрстки
  • разобраться, почему текст разъехался между локалями
  • перезапустить упавший QA-journey и убедиться, что фикс сработал

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

  • Отладь эту страницу: бейдж корзины пропадает после удаления последнего товара.
  • Проверь вёрстку после правки на мобильном и десктопе и сравни с эталонными скриншотами.
  • Прогони существующий QA-journey для чекаута и покажи, где он падает.

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

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

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install frontend-design-skills@claude-settings

Команда ставит плагин frontend-design-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill frontend-testing-debugging -a claude-code

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

~/.claude/skills/frontend-testing-debugging/SKILL.md

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

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

Вопросы о frontend-testing-debugging

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

Добавьте маркетплейс командой /plugin marketplace add fcakyon/claude-codex-settings, затем поставьте плагин, в который входит скилл: /plugin install frontend-design-skills@claude-settings.

Что делает frontend-testing-debugging?

Проводит агента через диагностику отрендеренного интерфейса: находит входной маршрут, повторяет сломанное взаимодействие, смотрит консоль и раскладку, вносит минимальную правку и перепроверяет результат на тех же шагах.

Нужен ли QA-плагин для работы скилла?

Нет, он работает независимо. qa:run-qa и qa:setup подключаются только тогда, когда QA-плагин установлен и в проекте есть его конфигурация.

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

SKILL.md · Apache-2.0
---
name: frontend-testing-debugging
description: This skill should be used when user asks to "debug this UI", "verify a rendered frontend change", or "check responsive layouts". Diagnose visual and interaction problems, compare reference screenshots, and reuse project QA journeys when available.
---

# Frontend testing and debugging

Own the visual diagnosis and fix loop. Reuse project testing infrastructure for repeatable execution, sessions and reports. This skill works independently of the QA plugin.

## Choose the flow and execution path

1. Identify the entry route, user action and expected visible result. Inspect repository scripts and running servers before asking for a missing URL. Keep the requested host exact.
2. Read project testing guidance and look for an existing journey covering the change. Run that journey first. When the QA plugin and project configuration are available, follow the project's QA skill and use `qa:run-qa` for execution, session recovery, telemetry isolation and cleanup.
3. Without project QA journeys, use the repository's existing browser or e2e workflow. For interactive investigation, choose an available browser tool and read its current instructions. Do not assume a particular plugin or API exists. Respect the user's browser preference and avoid taking focus during background work.
4. If no suitable workflow exists, use a temporary diagnostic script outside committed source. Add dependencies only when required by the task and permitted by the user. Report unavailable access or runtime support as a specific limitation.

Interactive inspection is useful for new visual issues and failed journeys. It does not replace a failing regression with an easier smoke check. Before visiting production, use the project's analytics isolation and test-account rules. If those are absent, prefer a local or staging target for diagnostic traffic.

## Inspect, fix and verify

Confirm the intended URL and meaningful rendered content. Check relevant console errors and framework overlays before diagnosing layout. Exercise the target interaction and observe its result through visible state, navigation or persisted application behavior.

For rendered validation, use the installed `ui-regression` skill when available. It owns state coverage, input contrast, asset density, screenshot inspection and the separate functional, rendered-quality and runtime verdicts. Keep investigation here and reuse the project runner for executable checks.

Without that skill, inspect desktop/mobile screenshots after media loads, exercise typed and cleared inputs, check contrast and asset sharpness at the target display density, and verify the intended surrounding layout across search results and empty states. Keep reference comparisons at matching state and viewport. Mark uninspected visuals as unverified.

When text changes unexpectedly between locales or screens, trace the source value through translation, formatting, Unicode normalization, JavaScript casing and CSS to the rendered result. Inspect inherited `lang`, text direction, font coverage and clipping where relevant. Distinguish translated interface copy from names, titles and identifiers whose spelling must survive presentation. Fix the owning transformation or layout rule instead of replacing individual characters, stripping accents, or forcing the whole page to one language. Use the actual content language for intentional transformations and locale formatting.

Make the smallest relevant edit, reload or rebuild as needed, and repeat the original failing interaction. Rerun affected project journeys. A passing build or root-page screenshot does not prove the interaction works.

Move repeatable discoveries into the existing tracked QA or e2e suite, with assertions on user-visible outcomes. Reuse its helpers instead of adding a second browser/session runner. When the QA plugin is available but the project has no suite, use `qa:setup` if creating repeatable coverage is within the task. Keep one-off diagnostic scripts and generated evidence outside Git.

## Evidence and cleanup

Report findings or verified behavior, the target URL and viewports, evidence supporting the result, and remaining gaps. Include screenshots when they prove visual changes. Distinguish automated journey results from interactive observations. Scale the response to the change rather than filling a fixed report template.

Close only task-created tabs and sessions, stop task-owned preview servers, and reset viewport overrides. Preserve unrelated tabs and saved authentication. Follow the project's evidence storage rules and do not create standalone reports unless requested.

## Related skills

Use `product-ui-design` for product UX, design rules and the desktop, mobile and supported-theme visual handoff. This skill owns browser execution and verification.

Use `openai-frontend-design` for design creation or fidelity to an accepted concept. Use the installed React best-practices skill for relevant React/Next.js changes. Image generation is only needed when the task calls for new or revised visual assets.

© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings

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

Все скиллы по теме «Тесты и QA» →

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

frontend-testing-debugging официальный OpenAI Скилл frontend-testing-debugging для Codex проверяет отрисованный интерфейс и помогает искать ошибки в UI. Он включается при тестировании локального приложения, отладке взаимодействий и визуальной проверке. CX Codex GP ChatGPT +1 159установок dark-mode-testing spencerpauly Скилл dark-mode-testing открывает страницу в браузере, снимает скриншоты в светлой и тёмной теме и указывает на потерянные цвета, невидимый текст и низкий контраст. CX Codex +1 478установок webapp-testing davila7 Команда webapp-testing для Claude Code, которая запускает браузерное тестирование локальных веб-приложений через Playwright. Проверяет UI, заполняет формы, делает скриншоты и собирает консольные логи. CX Codex +1 259установок frontend-testing-best-practices sergiodxa Скилл frontend-testing-best-practices для Claude Code задаёт 6 правил тестирования фронтенда: вместо изолированных юнит-тестов компонентов — сквозные E2E-тесты в Playwright. CX Codex +1 2 300установок testing Rudolf S. Скилл testing для написания эффективных тестов: правила мокирования по слоям, отладка падений, управление нестабильными тестами. CX Codex +1 ★ 587звёзд репо playwright-visual-testing bradtaylorsf Скилл playwright-visual-testing с готовыми шаблонами визуального регрессионного тестирования на Playwright. Помогает настроить скриншотные тесты компонентов, маски динамических данных и снимки в CI. CX Codex +1 1установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок

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

Весь набор →
schema Скилл schema для Claude Code и Codex проверяет и исправляет структурированные данные JSON-LD. Помогает выбрать тип разметки и понять, почему страница не получает расширенный результат. CX Codex +1 ★ 1 216звёзд репо python-guidelines Скилл python-guidelines задаёт правила написания и ревью Python-кода: интеграция в существующий код, запрет на лишние абстракции и единый формат докстрингов. CX Codex +1 ★ 1 216звёзд репо simplify Скилл simplify запускает параллельный разбор свежего diff по четырём направлениям и сразу вносит правки для упрощения кода перед коммитом. CX Codex +1 ★ 1 216звёзд репо navigation-native-navigators Правило navigation-native-navigators для Claude Code направляет выбор навигации в React Native на нативные компоненты. Оно охватывает стеки, вкладки и заголовки экранов. CX Codex +1 ★ 1 216звёзд репо programmatic-seo Скилл programmatic-seo помогает спланировать генерацию страниц по шаблонам и базам данных, чтобы защитить сайт от санкций поисковиков за бесполезный контент. CX Codex +1 ★ 1 216звёзд репо ultralytics-platform Скилл ultralytics-platform для Claude Code помогает управлять ресурсами Ultralytics Platform, обучать модели и запускать hosted inference. Подключается к запросам об отправке моделей и датасетов, облачном обучении и развёртывании endpoint. CX Codex +1 ★ 1 216звёзд репо ultralytics-branding Скилл ultralytics-branding загружает правила фирменного стиля Ultralytics: цвета, шрифты, правила логотипа и тон для PDF, презентаций, документов, email-рассылок и соцсетей. CX Codex +1 ★ 1 216звёзд репо email-design Скилл email-design для Claude Code и Codex помогает оформлять транзакционные письма приложений. Настраивает вёрстку подтверждений почты, сброса паролей и счетов под стиль продукта. CX Codex +1 ★ 1 216звёзд репо

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

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