Claude Skills by Vitammiin

Клиентское состояние на Zustand — слайсы, селекторы, персист, экшены; граница «что НЕ поднимать в глобальный стор». Use при проектировании или правке клиентских сторов состояния во фронтенде.

Read-only аудит покрытия OpenAPI/Swagger — найти роуты, не полностью покрытые спекой, на любом стеке (роль swagger). Use when нужно только НАЙТИ дыры покрытия без правок; покрывать найденное — $swagger-cover.

Покрыть роут/модуль OpenAPI/Swagger — параметры, ответы, описания, security + проверка, на любом стеке (роль swagger). Use when роут/модуль надо задокументировать (править код/спеку); найти дыры без правок — $swagger-audit.

Полное покрытие OpenAPI/Swagger для всех роутов бэкенда — детект стека (Fastify/Express/NestJS/Koa/Hapi/tRPC, статические спеки, не-JS), аудит непокрытых/частичных эндпоинтов и их корректное покрытие. Универсальный чек-лист операции; дефолт-пример — Fastify + zod как единый источник. Use при добавлении/ревью роутов, аудите документации API и перед генерацией фронт-клиента.

Точка входа в Task Master workflow для полного покрытия OpenAPI/Swagger на любом стеке (роль swagger). Use when доводим покрытие спеки до полного по многим роутам циклом задач; один роут — $swagger-cover, только найти дыры — $swagger-audit.

Персона «OpenAPI/Swagger Coverage Engineer» — инженер полного покрытия OpenAPI/Swagger на любом стеке (Fastify/Express/NestJS/Koa/Hapi/tRPC, статические спеки, не-JS). Определяет стек, находит роуты, не полностью покрытые спекой, и корректно, с описаниями, покрывает их. Аудит read-only, покрытие — write, по циклу Task Master.

Проектирование распределённых систем — декомпозиция монолита на модули/сервисы (критерии границ), синхронное vs асинхронное взаимодействие (очереди, события), уровни масштабирования 100 → 10k RPS (кэш → реплики → шардинг), отказоустойчивость, наблюдаемость, что рисовать на архитектурной диаграмме. Use при проектировании архитектуры, обсуждении границ сервисов, очередей, масштабирования, отказоустойчивости.

Tailwind CSS v4 (CSS-first) — установка (Vite `@tailwindcss/vite`, PostCSS, CLI), конфигурация через `@import "tailwindcss"` + `@theme` (дизайн-токены как CSS-переменные, OKLCH), utility-first, варианты через cva/cn, адаптивность и container queries, тёмная тема, доступность. Use при стилизации UI и настройке дизайн-системы на Tailwind.

Выбрать и проверить AI provider/model Task Master для main, research и fallback без раскрытия ключей.

Справочник Task Master: MCP/CLI, задачи, статусы, scoped run, safe retry и fallback. Use для persistent task tracking; дисциплину и режимы задаёт $workflow.

Инженерная документация — структура README, копипастабельные примеры, таблицы vs проза, многоязычный паритет (RU/EN), ADR-формат, Keep a Changelog, стиль без воды. Use при написании/обновлении README, docs/*, CONTRIBUTING, ARCHITECTURE, CHANGELOG, release notes и аудите дрейфа доков.

Отчёт покрытия с находками — что критично не покрыто, задачи на закрытие дыр (роль testing). Use when нужно понять реальное покрытие и спланировать его рост.

Playwright e2e-сценарии критического пути — селекторы по ролям, fixtures/auth-state, web-first assertions, trace при падении (роль testing). Use when нужно проверить пользовательский сценарий в реальном браузере.

Диагностика и лечение нестабильного (flaky) теста — race/timing/shared state/моки; фикс первопричины до 10 зелёных прогонов подряд (роль testing). Use when тест падает «иногда» или только в CI.

Интеграционные тесты — API через Supertest/inject, БД с testcontainers или тестовой копией (роль testing). Use when нужно проверить связку роут → сервис → БД или контракт API.

Стратегия тестирования — пирамида unit/integration/e2e, что мокать (границы I/O) а что нет (домен, своя БД в integration), осмысленные пороги покрытия, AAA/given-when-then, критерии хорошего теста, причины flaky → фиксы. Use при проектировании/ревью тестов, выборе уровня и лечении нестабильных.

Unit-тесты (Vitest/Jest) для файла/модуля — happy path + границы + ошибки, с реальным прогоном и выводом (роль testing). Use when нужно покрыть функцию/модуль модульными тестами.

Независимая read-only верификация claimed задачи по testStrategy. Checker не меняет implementation, acceptance tests или статусы; возвращает evidence-based ГОТОВО/НЕ ГОТОВО Orchestrator-у.

Цель тестирования через Task Master — покрытие/верификация до готового, зелёные прогоны как доказательство (роль testing). Use when дана цель по тестам и её нужно довести через задачи.

Персона «Testing & Verification Engineer» — пишет и прогоняет unit (Vitest/Jest), интеграционные (Supertest/`inject`, testcontainers) и e2e (Playwright) тесты, снимает покрытие, лечит flaky. Исполняет testStrategy задач Task Master и выносит вердикт «готово/не готово» строго с выводом прогонов — замыкает цикл «реализация → проверка → done». Use when нужно написать тесты, верифицировать задачу перед done, снять покрытие или вылечить нестабильный тест.

Строгая типизация серверного кода на TypeScript — tagged unions и Result<T,E>, generics для типобезопасных API-клиентов, strictNullChecks и optional chaining, exhaustive switch с never-проверкой, вывод типов из zod (z.infer). Use при написании или улучшении типов, обработке ошибок через Result, синхронизации zod-схем и типов, борьбе с any и небезопасными кастами.

UI source mapping: скриншот работающего интерфейса в существующие route, component, control, handler и API с file:line.

Работа с Vercel через официальный MCP (mcp.vercel.com) — деплойменты, логи, проекты и веб-аналитика, поиск по докам Vercel. Use при деплое на Vercel, разборе упавших сборок и логов, управлении проектами или анализе трафика.

Анализирует скриншот сайта как визуальное доказательство, определяет продукт и страницу, ищет официальную документацию, сверяет live data и отвечает с URL и уверенностью.

Ответить на вопрос по скриншоту после сверки официальной документации и актуальных данных сайта.

Дать безопасную пошаговую подсказку по интерфейсу на скриншоте, подтверждённую официальной документацией.

Определить сайт, продукт, страницу и функцию по скриншоту с проверкой официального домена и документации.

Найти реальный сайт, страницу или официальную документацию по признакам со скриншота.

Многошаговый анализ скриншотов через Task Master с документацией, live-проверкой и доказательным ответом.

Персона анализа скриншотов с веб-проверкой. Определяет сайт и функцию, ищет официальную документацию, сверяет реальные данные сайта и отвечает с URL.

Универсальный scoped Task Master orchestrator: фиксирует IDs текущей цели, атомарно claim-ит их и делегирует реализацию и независимую проверку. Use для нетривиальной tracked/remediation цели любого домена.

Маршрутизирует search, scrape, map, crawl, extract, interact, parse, monitor, research и support через Firecrawl CLI, MCP или REST; также направляет app integration и workflow deliverables.

Безопасный scoped Task Master workflow: captured task IDs, atomic claim, независимый Checker и явные report-only/track-only/remediation режимы. Use для нетривиальной реализации или persistent task tracking.

Анализирует одновременно пользовательскую цель и фактический workspace, затем выбирает минимальный набор Agent-Vorcl-Flow ролей и доменных скиллов с evidence и negative criteria. Use для architect/analyzer/audit/vorcl маршрутизации; не использовать вместо реализации выбранной роли.

broad read-only code quality audit. Primary owner: bugs, types, DB and structural review. Do not use for: targeted hardcode or mock-data audit. Use when this role is selected by the Agent-Vorcl-Flow router.

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

Проектирование HTTP API — REST-конвенции (ресурсы, методы, статус-коды), пагинация (cursor vs offset), версионирование, идемпотентность (Idempotency-Key), формат ошибок RFC 7807 (problem+json), безопасность и rate limiting. Use при проектировании, ревью или версионировании API и эндпоинтов, выборе кодов ошибок, пагинации, лимитов или формата ответа.

system design and technology choices. Primary owner: target architecture. Do not use for: code-grounded full repository package. Use when this role is selected by the Agent-Vorcl-Flow router.

Карта архитектуры кода из любого TS/JS-репозитория — детерминированный extraction скриптами в architecture.json (каждый узел с source:{file,line}) и rendering в интерактивный HTML, draw.io, Mermaid, ARCHITECTURE.md и PDF. Use when нужно построить карту архитектуры, ERD, граф связей «кто к чему имеет доступ» (базы, роуты, AI-агенты, память, env, технологии) или интерактивную схему по коду. Триггеры — карта архитектуры, architecture map, ERD по коду, граф зависимостей, визуализировать проект, a...

Обязательные правила модульной архитектуры бэкенда — src/modules/* со слоями controller/service/repository/routes/schemas/dto/types/middleware/index. Use ВСЕГДА при создании или изменении структуры backend-кода, новых модулей, эндпоинтов и файлов внутри модуля.

server APIs and business logic. Primary owner: backend implementation. Do not use for: frontend UI. Use when this role is selected by the Agent-Vorcl-Flow router.

CI/CD на GitHub Actions — эталонный PR-workflow (lint+typecheck+test с кэшем npm/pnpm), deploy-workflow с environment и secrets, concurrency (отмена устаревших прогонов), matrix, безопасность (минимальные permissions, опасность pull_request_target, секреты и fork-PR), интеграция с Render (deploy hook / auto-deploy). Use when настраиваешь или чинишь GitHub Actions, pipeline, кэширование CI или деплой по пушу.

Cross-language read-only audit engine for production hardcode and leaked mocks/fake data in frontend, backend, mobile, templates, and shared code. Use when Codex must scan TS/JS, Python, Go, Java/Kotlin, C#, PHP, Ruby, Rust, Vue/Svelte/HTML, or mixed repositories and produce evidence-based file:line findings while separating tests, fixtures, stories, seeds, examples, generated files, and vendored code.

Серверное состояние на TanStack Query (React Query) поверх реального API бэкенда. Источник истины — OpenAPI-спека бэка (Fastify/NestJS/Express и др.): типы генерируются из спеки (openapi-typescript), запросы идут типобезопасным openapi-fetch. Ключи, кэш, инвалидация, мутации, оптимистичные обновления, RSC/Server Actions. Моков в прод-пути нет. Use при загрузке/мутации серверных данных во фронтенде.

Моделирование данных и выбор хранилищ — реляционные/документные/KV, индексы, транзакции, партиционирование, миграции без простоя. Use при проектировании схемы БД или выборе хранилища.

Полная локальная дизайн-студия Agent-Vorcl-Flow: создаёт self-contained HTML-макеты, интерактивные прототипы, wireframe, лендинги, dashboards, mobile screens, презентации, документы, анимации, 3D, визуализации, email и печатные материалы; импортирует Figma, GitHub и HTML/CSS; создаёт и применяет design systems; экспортирует собственные deck-stage проекты в PDF/PPTX/MP4. Use когда нужно спроектировать, визуализировать, прототипировать, собрать deck/PPT, дизайн-систему или визуальный артефакт, ...

Docker and CI/CD. Primary owner: container and pipeline implementation. Do not use for: Render-specific operations. Use when this role is selected by the Agent-Vorcl-Flow router.

Docker для Node-проектов — эталонный multistage Dockerfile (node-slim, npm ci --omit=dev, non-root, HEALTHCHECK), оптимизация слоёв и размера, безопасность (.dockerignore, секреты не в слои), docker-compose для локальной разработки (healthcheck, volumes, env), критичное правило force-recreate vs restart, типовые ошибки (ECONNREFUSED между сервисами). Use when пишешь/ревьюишь Dockerfile или docker-compose, чинишь сборку/поднятие контейнеров или применяешь env-изменения.

README, API and architecture documentation. Primary owner: documentation lifecycle. Do not use for: architecture extraction. Use when this role is selected by the Agent-Vorcl-Flow router.

Создание диаграмм в нативном XML-формате draw.io / diagrams.net — структура файла (`mxfile`/`mxGraphModel`/`mxCell`/`mxGeometry`), ID-менеджмент, стили (`key=value;`), каталог фигур и рёбер, типы диаграмм (flowchart, cross-functional/swimlane, BPMN, UML, network/cloud, ERD, org chart, mind map), подключение custom-библиотек (`?clibs=`), правила качества и валидность XML. Use при создании, конвертации или правке диаграмм draw.io/diagrams.net.