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

rails-application-ui-blocks — скилл для Claude Code: установка и обзор

Скилл rails-application-ui-blocks собирает страницы Ruby on Rails и обновляет ERB-шаблоны готовыми блоками UI без потери Stimulus и Turbo.

MIT 257 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a claude-code
Открыть на GitHub

Что делает rails-application-ui-blocks

Скилл внедряет блоки разметки из каталога templates/application-ui в представления Rails. Он работает в двух режимах: new-page для создания экранов с нуля и refactor-page для пошаговой замены вёрстки в существующих шаблонах. При создании новой страницы процесс начинается с каркаса (ui.page-examples.* и ui.application-shells.*), затем добавляются заголовки, формы, списки и оверлеи. При рефакторинге разметка заменяется по регионам с проверкой тестов после каждого шага.

Главное правило инструмента — сохранять всю серверную и клиентскую логику. Он прямо запрещает менять контроллеры, модели, а также удалять атрибуты data-controller, data-action, data-turbo-* и теги доступности aria-*. Для подбора блоков используются references/selection-playbook.md и реестр references/template-catalog.json. Если файлы в templates/application-ui меняются, каталог нужно пересобрать скриптом scripts/build_template_catalog.py на Python 3.

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

  • собрать панель администратора на Rails из готовых блоков
  • перевести разрозненную ERB-вёрстку на шаблоны из каталога
  • сохранить хуки Turbo и Stimulus при переработке интерфейса
  • структурировать выбор UI-компонентов для новых представлений

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

  • Собери новый дашборд в режиме new-page, используя блоки из templates/application-ui
  • Замени разметку формы в app/views/users/edit.html.erb на блок из каталога, сохранив data-controller
  • Перегенерируй каталог шаблонов через scripts/build_template_catalog.py

Как установить rails-application-ui-blocks

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a claude-code

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

~/.claude/skills/rails-application-ui-blocks/SKILL.md

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

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

Вопросы о rails-application-ui-blocks

Как установить rails-application-ui-blocks в Claude Code?

Выполните команду npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a claude-code. Файл навыка сохранится в ~/.claude/skills/rails-application-ui-blocks/SKILL.md.

Что делает этот скилл?

Он помогает ИИ-агенту находить подходящие блоки в каталоге templates/application-ui и аккуратно встраивать их в ERB-шаблоны Rails. При этом контроллеры, атрибуты доступности и хуки Turbo или Stimulus остаются нетронутыми.

Что делать после добавления новых шаблонов в templates/application-ui?

Каталог необходимо обновить вручную с помощью Python-скрипта: запустите python3 .agents/skills/rails-application-ui-blocks/scripts/build_template_catalog.py --root ..

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

SKILL.md · MIT
---
name: rails-application-ui-blocks
description: Compose new Rails backend pages and refactor existing Rails UI to use premium blocks from templates/application-ui. Use when requests mention ERB views, Rails partials, admin/dashboard screens, Tailwind UI assembly, or replacing custom markup with existing premium blocks while preserving behavior, accessibility, and Turbo/Stimulus hooks.
---

# Rails Application UI Blocks

Use this skill to choose, adapt, and integrate premium UI blocks from `templates/application-ui` into Rails views.

## Workflow

1. Determine mode:
- new-page for brand new features/pages
- refactor-page for existing views/partials
2. Identify constraints first:
- Required interactions (Turbo Frames/Streams, Stimulus targets/actions, form semantics)
- Accessibility constraints (labels, keyboard flow, ARIA)
- Existing component boundaries (partials, helpers, shared layouts)
3. Pick candidate blocks from catalog:
- Read `references/selection-playbook.md`
- Query `references/template-catalog.json`
4. Integrate minimally:
- Keep existing routes/controllers/domain logic unchanged
- Replace markup in thin steps (shell first, then sections, then micro-components)
5. Verify:
- Ensure no loss of behavior, accessibility, or test coverage
- Keep existing design tokens and class conventions where required by project standards

## Selection Order

For `new-page`:
1. Start with `ui.page-examples.*` to anchor page structure.
2. Choose shell from `ui.application-shells.*`.
3. Add page/section headings from `ui.headings.*`.
4. Add core body blocks (`ui.forms.*`, `ui.lists.*`, `ui.data-display.*`, `ui.feedback.*`).
5. Finish with navigation and overlay details (`ui.navigation.*`, `ui.overlays.*`).

For `refactor-page`:
1. Preserve current information architecture and interaction contracts.
2. Map each existing UI region to one candidate catalog block.
3. Replace one region at a time and run relevant tests.
4. Extract repeated markup into partials only after reuse is proven.

## Guardrails

- Do not change controllers/models/policies unless explicitly requested.
- Do not remove `data-controller`, `data-action`, `data-turbo-*`, `aria-*`, or form field names without replacement.
- Prefer adapting blocks to project styles over introducing conflicting visual systems.
- Avoid block insertion that duplicates existing design-system components when native components already solve the same need.

## Output Expectations

When completing a task with this skill, include:
- Selected catalog IDs (for traceability)
- Source template paths used
- Any behavior/accessibility deltas introduced
- What was intentionally not replaced and why

## Resources

- `references/selection-playbook.md`
  - Decision rules for what template families to check first, and when not to use them.
- `references/template-catalog.json`
  - Canonical block IDs with aliases and source paths.
- `scripts/build_template_catalog.py`
  - Regenerates the catalog after template updates.

## Maintenance

Regenerate the catalog when files under `templates/application-ui` change:

```bash
python3 .agents/skills/rails-application-ui-blocks/scripts/build_template_catalog.py \
  --root .
```

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Фронтенд и UI» →
rails-hotwire TheBushidoCollective Скилл rails-hotwire для Claude Code, Codex, Cursor и других агентов, который учит строить реактивные Rails-приложения через Hotwire: Turbo Frames, Turbo Streams и Stimulus без тяжёлых JS-фреймворков. CX Codex +1 349установок ruby-on-rails-best-practices sergiodxa Скилл ruby-on-rails-best-practices для Claude Code описывает 16 правил архитектуры Rails из практики Basecamp: модели, тонкие контроллеры, фоновые задачи и Turbo Streams. CX Codex +1 283установок ruby-rails-application aj-geddes Скилл ruby-rails-application помогает создавать приложения на Ruby on Rails по архитектуре MVC. Настраивает модели Active Record, REST-контроллеры, JWT-аутентификацию и миграции базы данных. CX Codex +1 661установок inertia-rails-typescript inertia-rails Скилл inertia-rails-typescript настраивает строгую типизацию TypeScript в Inertia Rails для React, Vue и Svelte. Помогает исправить ошибки TS2344 и TS2339. CX Codex +1 482установок inertia-rails-setup inertia-rails Скилл inertia-rails-setup анализирует стек Inertia Rails в проекте, подбирает недостающие библиотеки и генерирует блок конфигурации в CLAUDE.md. Помогает при первом старте или смене инструментов. CX Codex +1 432установок rails-expert VoltAgent Субагент rails-expert для Codex разбирает изменения в Ruby on Rails — от маршрута и модели до ответа клиенту. Ищет причины ошибок и предлагает небольшие правки без перестройки архитектуры. CX Codex ★ 6 505звёзд репо

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

Весь набор →
bug-review Скилл bug-review для Claude Code выполняет пять параллельных проходов по диффу PR, отбирает находки большинством голосов и проверяет их отдельным валидатором на Opus. Баги выявляются до мержа. CX Codex +1 264установок effect-ts Скилл с рекомендациями и шаблонами по библиотеке Effect-TS в TypeScript: типизированные ошибки, сервисы через Layer и генераторы Effect.gen. CX Codex +1 263установок nginx-c-module-debug Скилл nginx-c-module-debug для Claude Code помогает разбирать падения nginx C-модулей, ошибки памяти и сбои в потоке запросов. Для диагностики используются GDB, core dump и трассировка. CX Codex +1 260установок rust-write-tests Скилл rust-write-tests направляет агента при написании надёжных тестов на Rust: проверяет инварианты, выносит тесты в отдельные файлы и устраняет флакующие проверки. CX Codex +1 257установок rust-implement Скилл rust-implement организует написание Rust-кода в четыре прохода: от проектирования типов и сигнатур до чистки и запуска скрипта проверки. CX Codex +1 254установок domain-architect Скилл domain-architect определяет бизнес-домены в Swift-проекте через возможности продукта, а не через имена папок. Строит карту слоёв каждого домена — от типов до UI. CX Codex +1 249установок app-planner Скилл app-planner составляет дизайн-план приложения в Markdown по паттернам Apple Design DNA перед разработкой. Делит проект на майлстоуны для сессий сборки. CX Codex +1 244установок threat-model Скилл threat-model строит модель угроз кодовой базы, отслеживая путь недоверенных данных до приёмников и собирая отдельные уязвимости в цепочки атак. CX Codex +1 243установок

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

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