rails-application-ui-blocks — скилл для Claude Code: установка и обзор
Скилл rails-application-ui-blocks собирает страницы Ruby on Rails и обновляет ERB-шаблоны готовыми блоками UI без потери Stimulus и Turbo.
MIT 257 установок ★ 227 обновлён 2026-08-15
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/rails-application-ui-blocks/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rails-application-ui-blocks/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a codex2Вручную: положить файлы
.agents/skills/rails-application-ui-blocks/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a cursor2Вручную: положить файлы
.cursor/skills/rails-application-ui-blocks/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pproenca/dot-skills skills/.experimental/rails-application-ui-blocks2Вручную: положить файлы
.github/skills/rails-application-ui-blocks/SKILL.md1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a gemini-cli2Командой платформы
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/rails-application-ui-blocksВручную: положить файлы
.devin/skills/rails-application-ui-blocks/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill rails-application-ui-blocks -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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