Symfony UX Skills
smnandre/symfony-ux-skills
Skills de IA para o ecossistema Symfony UX — Stimulus, Turbo, LiveComponent
Ver no GitHubConjunto de skills para agentes de IA (Claude, Gemini, Codex) que capacita o desenvolvimento com a stack frontend Symfony UX. Cobre Stimulus, Turbo, TwigComponent, LiveComponent, UX Icons e UX Map com orientação sobre quando usar cada ferramenta.
Instalação
npx convez-ai smnandre/symfony-ux-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auxiliar na escolha entre ferramentas do Symfony UX
- Gerar código para controladores Stimulus e comportamentos client-side
- Implementar atualizações parciais e real-time com Turbo e Mercure
- Criar componentes reutilizáveis com TwigComponent e LiveComponent
- Integrar ícones SVG e mapas interativos em templates Twig
Veredito

Skills bem estruturados e práticos para o ecossistema Symfony UX. Cobertura sólida das ferramentas principais com padrões, APIs e gotchas documentados — essencial para quem trabalha com essa stack de frontend reativo em Symfony.
README
A tradução para o português deste README ainda está na fila.
Symfony UX -- Agent Skills
AI agent skills for the Symfony UX frontend stack -- Stimulus, Turbo, TwigComponent, LiveComponent, UX Icons and UX Map.
By Simon Andre
Skills
| Skill | What it does | When the agent activates it | Refs |
|---|---|---|---|
| symfony-ux | Orchestrator / decision tree | The developer asks "which UX tool should I use?" or a question that spans multiple packages | -- |
| stimulus | Stimulus controllers, targets, values, actions, outlets | Client-side JS behavior -- toggles, dropdowns, modals, wrapping a JS library | api, patterns, gotchas |
| turbo | Turbo Drive, Frames, Streams, Mercure | Partial page updates, SPA-like nav, real-time server pushes -- no JS to write | api, patterns, gotchas |
| twig-component | TwigComponent props, blocks, computed properties, anonymous components | Reusable UI building blocks -- buttons, cards, alerts, design system | api, patterns, gotchas |
| live-component | LiveComponent props, actions, data-model, forms, emit, defer/lazy | Reactive server-rendered UI -- live search, validation, dependent selects | api, patterns, gotchas |
| ux-icons | SVG icons via Iconify, local files, aliases, CLI | Rendering icons in Twig -- Lucide, Heroicons, Tabler, Material Design, etc. | api, patterns, gotchas |
| ux-map | Interactive maps with Leaflet / Google Maps | Maps with markers, polygons, polylines, circles, events, LiveComponent integration | api, patterns, gotchas |
Upstream packages: symfony/stimulus-bundle -- symfony/ux-turbo -- symfony/ux-twig-component -- symfony/ux-live-component -- symfony/ux-icons -- symfony/ux-map
Installation
Claude Code Plugin
This repository is installable as a Claude Code plugin. Skills are automatically discovered and namespaced under symfony-ux:.
# Test locally
claude --plugin-dir /path/to/symfony-ux-skills
# Or install from a marketplace (if available)
claude plugin install symfony-ux
Vercel's Skills CLI
npx skills add smnandre/symfony-ux-skills
Manual installation
Copy each skill directory into your platform's skills location:
# Claude Code (project-level, shared via git)
mkdir -p .claude/skills && cp -r skills/* .claude/skills/
# Claude Code (user-level, available everywhere)
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/
Then optionally copy the context file for your platform to your project root:
cp CLAUDE.md /path/to/project/ # Claude Code
cp AGENTS.md /path/to/project/ # OpenAI Codex
cp GEMINI.md /path/to/project/ # Gemini CLI
How it works
Agent skills are structured knowledge files that teach AI coding agents how to use a library. Instead of relying on training data (which may be outdated or incomplete), the agent reads the skill at runtime and gets accurate, version-specific guidance: API references, common patterns, and known gotchas.
Each skill follows a progressive disclosure pattern:
- Description (YAML frontmatter) -- always loaded; tells the agent when to activate the skill (~100 words)
- SKILL.md body -- loaded on activation; quick-reference with the most important rules and examples
- references/ -- loaded on demand; deep API docs, advanced patterns, and common pitfalls
This means the agent only pulls in what it needs, keeping context windows lean.
Built on the Agent Skills open standard. Compatible with Claude Code, Gemini CLI, OpenAI Codex, Cursor, Windsurf, and any platform that supports SKILL.md.
Project context files
Optional files for your project root. They give the agent a quick decision tree and key rules so it knows which skill to reach for.
| File | Platform |
|---|---|
CLAUDE.md | Claude Code |
AGENTS.md | OpenAI Codex |
GEMINI.md | Gemini CLI |
llms.txt | Web / any LLM (llmstxt.org) |
Repository structure
.
├── CLAUDE.md # Context file for Claude Code
├── AGENTS.md # Context file for OpenAI Codex
├── GEMINI.md # Context file for Gemini CLI
├── llms.txt # Context file for web / LLMs
├── .claude-plugin/
│ └── plugin.json # Claude Code plugin manifest
├── gemini-extension.json # Gemini CLI extension manifest
└── 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
Coverage
Targets Symfony UX 2.22 -- 2.28+, Symfony 7.2 / 7.4 / 8.0, PHP 8.4+.
Documented features include <twig:Turbo:Stream:*> component syntax (UX 2.22), TurboStreamResponse helper, LiveProp URL binding with validation modifiers, defer / lazy loading for LiveComponents, UX Toolkit (copy-paste UI components), Iconify on-demand icons with ux:icons:lock CLI, and UX Map with Leaflet/Google Maps renderers including polygons, polylines, circles and ComponentWithMapTrait.
Author
Simon Andre -- smnandre.dev -- GitHub -- Twitter
License
MIT