Symfony UX Skills
smnandre/symfony-ux-skillsСтруктурированные знания о стеке Symfony UX для AI-агентов (Claude, Gemini, Codex). Охватывает Stimulus, Turbo, TwigComponent, LiveComponent, UX Icons и UX Map — с API-справочниками, паттернами и типичными ошибками.
Установка
npx skills add smnandre/symfony-ux-skillsREADME
Symfony UX — Навыки для агентов
Навыки AI-агентов для фронтенд-стека Symfony UX — Stimulus, Turbo, TwigComponent, LiveComponent, UX Icons и UX Map.
Автор: Simon Andre
Навыки
| Навык | Что делает | Когда агент его активирует | Справочники |
|---|---|---|---|
| symfony-ux | Оркестратор / дерево решений | Разработчик спрашивает «какой UX-инструмент использовать?» или задаёт вопрос, затрагивающий несколько пакетов | -- |
| stimulus | Контроллеры Stimulus, targets, values, actions, outlets | Клиентское JS-поведение — переключатели, выпадающие меню, модалки, обёртка JS-библиотек | api, patterns, gotchas |
| turbo | Turbo Drive, Frames, Streams, Mercure | Частичное обновление страниц, SPA-навигация, серверные push-уведомления в реальном времени — без написания JS | api, patterns, gotchas |
| twig-component | Пропсы TwigComponent, блоки, вычисляемые свойства, анонимные компоненты | Переиспользуемые UI-блоки — кнопки, карточки, алерты, дизайн-система | api, patterns, gotchas |
| live-component | Пропсы LiveComponent, actions, data-model, формы, emit, defer/lazy | Реактивный серверный UI — живой поиск, валидация, зависимые селекты | api, patterns, gotchas |
| ux-icons | SVG-иконки через Iconify, локальные файлы, псевдонимы, CLI | Рендеринг иконок в Twig — Lucide, Heroicons, Tabler, Material Design и др. | api, patterns, gotchas |
| ux-map | Интерактивные карты с Leaflet / Google Maps | Карты с маркерами, полигонами, полилиниями, кругами, событиями, интеграция с LiveComponent | api, patterns, gotchas |
Пакеты upstream: symfony/stimulus-bundle -- symfony/ux-turbo -- symfony/ux-twig-component -- symfony/ux-live-component -- symfony/ux-icons -- symfony/ux-map
Установка
Плагин Claude Code
Репозиторий устанавливается как плагин Claude Code. Навыки автоматически обнаруживаются и получают пространство имён symfony-ux:.
# Локальное тестирование
claude --plugin-dir /path/to/symfony-ux-skills
# Или установка из маркетплейса (если доступен)
claude plugin install symfony-uxVercel Skills CLI
npx skills add smnandre/symfony-ux-skills
Ручная установка
Скопируйте каждую директорию навыка в соответствующее расположение для вашей платформы:
# Claude Code (уровень проекта, общий доступ через git)
mkdir -p .claude/skills && cp -r skills/* .claude/skills/
# Claude Code (уровень пользователя, доступен везде)
cp -r skills/* ~/.claude/skills/
# Gemini CLI
mkdir -p ~/.gemini/skills && cp -r skills/* ~/.gemini/skills/
# OpenAI Codex
mkdir -p .codex/skills && cp -r skills/* .codex/skills/Затем при необходимости скопируйте контекстный файл для вашей платформы в корень проекта:
cp CLAUDE.md /path/to/project/ # Claude Code
cp AGENTS.md /path/to/project/ # OpenAI Codex
cp GEMINI.md /path/to/project/ # Gemini CLIКак это работает
Навыки агентов — это структурированные файлы знаний, которые обучают AI-агентов тому, как использовать библиотеку. Вместо того чтобы полагаться на обучающие данные (которые могут быть устаревшими или неполными), агент читает навык во время выполнения и получает точные, версионно-специфичные инструкции: справочники API, распространённые паттерны и известные подводные камни.
Каждый навык следует паттерну прогрессивного раскрытия:
- Описание (YAML frontmatter) — загружается всегда; сообщает агенту когда активировать навык (~100 слов)
- Тело SKILL.md — загружается при активации; краткий справочник с наиболее важными правилами и примерами
- references/ — загружается по требованию; подробная документация API, продвинутые паттерны и типичные ошибки
Это означает, что агент подгружает только то, что нужно, сохраняя контекстные окна компактными.
Построено на открытом стандарте Agent Skills. Совместимо с Claude Code, Gemini CLI, OpenAI Codex, Cursor, Windsurf и любой платформой, поддерживающей SKILL.md.
Контекстные файлы проекта
Опциональные файлы для корня проекта. Они дают агенту краткое дерево решений и ключевые правила, чтобы он знал, какой навык использовать.
| Файл | Платформа |
|---|---|
CLAUDE.md | Claude Code |
AGENTS.md | OpenAI Codex |
GEMINI.md | Gemini CLI |
llms.txt | Web / любой LLM (llmstxt.org) |
Структура репозитория
.
├── CLAUDE.md # Контекстный файл для Claude Code
├── AGENTS.md # Контекстный файл для OpenAI Codex
├── GEMINI.md # Контекстный файл для Gemini CLI
├── llms.txt # Контекстный файл для web / LLM
├── .claude-plugin/
│ └── plugin.json # Манифест плагина Claude Code
├── gemini-extension.json # Манифест расширения Gemini CLI
└── skills/
├── symfony-ux/
│ └── SKILL.md
├── stimulus/
│ ├── SKILL.md
│ └── references/
│ ├── api.md
│ ├── patterns.md
│ └── gotchas.md
├── turbo/
│ ├── SKILL.md
│ └── references/
│ ├── api.md
│ ├── patterns.md
│ └── gotchas.md
├── twig-component/
│ ├── SKILL.md
│ └── references/
│ ├── api.md
│ ├── patterns.md
│ └── gotchas.md
├── live-component/
│ ├── SKILL.md
│ └── references/
│ ├── api.md
│ ├── patterns.md
│ └── gotchas.md
├── ux-icons/
│ ├── SKILL.md
│ └── references/
│ ├── api.md
│ ├── patterns.md
│ └── gotchas.md
└── ux-map/
├── SKILL.md
└── references/
├── api.md
├── patterns.md
└── gotchas.md