convez.ai
SkillDesenvolvimento WebIntermediário
smnandre

Symfony UX Skills

smnandre/symfony-ux-skills

Skills de IA para o ecossistema Symfony UX — Stimulus, Turbo, LiveComponent

Ver no GitHub
BomPluginScore · de 0 a 100

Conjunto 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-skills

1 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

Estrelas
187
Forks
15
Acompanhando
4
Saúde
42%
Último commit
há 5 dias
Versão
v1.2.0
Issues abertas
2
Contribuidores
4

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

Trigger warning animals

AI agent skills for the Symfony UX frontend stack -- Stimulus, Turbo, TwigComponent, LiveComponent, UX Icons and UX Map.

By Simon Andre

Skills

SkillWhat it doesWhen the agent activates itRefs
symfony-uxOrchestrator / decision treeThe developer asks "which UX tool should I use?" or a question that spans multiple packages--
stimulusStimulus controllers, targets, values, actions, outletsClient-side JS behavior -- toggles, dropdowns, modals, wrapping a JS libraryapi, patterns, gotchas
turboTurbo Drive, Frames, Streams, MercurePartial page updates, SPA-like nav, real-time server pushes -- no JS to writeapi, patterns, gotchas
twig-componentTwigComponent props, blocks, computed properties, anonymous componentsReusable UI building blocks -- buttons, cards, alerts, design systemapi, patterns, gotchas
live-componentLiveComponent props, actions, data-model, forms, emit, defer/lazyReactive server-rendered UI -- live search, validation, dependent selectsapi, patterns, gotchas
ux-iconsSVG icons via Iconify, local files, aliases, CLIRendering icons in Twig -- Lucide, Heroicons, Tabler, Material Design, etc.api, patterns, gotchas
ux-mapInteractive maps with Leaflet / Google MapsMaps with markers, polygons, polylines, circles, events, LiveComponent integrationapi, 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:

  1. Description (YAML frontmatter) -- always loaded; tells the agent when to activate the skill (~100 words)
  2. SKILL.md body -- loaded on activation; quick-reference with the most important rules and examples
  3. 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.

FilePlatform
CLAUDE.mdClaude Code
AGENTS.mdOpenAI Codex
GEMINI.mdGemini CLI
llms.txtWeb / 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

Ver o original no GitHub

Bom para

Relacionados