/ Directory / Playground / symfony-ux-skills
● Community smnandre ⚡ Instant

symfony-ux-skills

by smnandre · smnandre/symfony-ux-skills

Teach Claude the Symfony UX stack — Live Component, Twig Component, Turbo, Stimulus — so it writes idiomatic full-stack Symfony code.

A bundle of Agent Skills that document the Symfony UX ecosystem (Live Components, Twig Components, Turbo, Stimulus controllers, Autocomplete, React/Vue/Svelte integration). Once cloned into ~/.claude/skills/, Claude loads the relevant skill whenever you ask for a Live Component, a Stimulus controller, or a Turbo Frame, and follows Symfony UX conventions instead of inventing patterns.

Why use it

Key features

Live Demo

What it looks like in practice

symfony-ux-skill.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "symfony-ux-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/smnandre/symfony-ux-skills",
        "~/.claude/skills/symfony-ux-skills"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "symfony-ux-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/smnandre/symfony-ux-skills",
        "~/.claude/skills/symfony-ux-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "symfony-ux-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/smnandre/symfony-ux-skills",
        "~/.claude/skills/symfony-ux-skills"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "symfony-ux-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/smnandre/symfony-ux-skills",
        "~/.claude/skills/symfony-ux-skills"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "symfony-ux-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/smnandre/symfony-ux-skills",
        "~/.claude/skills/symfony-ux-skills"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "symfony-ux-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/smnandre/symfony-ux-skills",
          "~/.claude/skills/symfony-ux-skills"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add symfony-ux-skill -- git clone https://github.com/smnandre/symfony-ux-skills ~/.claude/skills/symfony-ux-skills

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use symfony-ux-skills

How to build a Symfony Live Component with Claude

👤 Symfony developers adding real-time UI without writing JS ⏱ ~20 min intermediate

When to use: You need a reactive form, filter, or list that updates on the server without a full page reload.

Prerequisites
  • Symfony 6.4+ project with symfony/ux-live-component installed — composer require symfony/ux-live-component
  • Skill cloned into ~/.claude/skills/ — git clone https://github.com/smnandre/symfony-ux-skills ~/.claude/skills/symfony-ux-skills
Flow
  1. Describe the component you need
    Build a Live Component for a product search filter with checkboxes for categories and a text query — updates results live as the user types.✓ Copied
    → Claude references LiveProp, LiveAction, debounce modifiers from the skill
  2. Let Claude scaffold the PHP + Twig
    Generate the PHP component class and the Twig template. Use attributes, not annotations.✓ Copied
    → File output follows Symfony UX naming (src/Twig/Components/...)
  3. Ask Claude to wire the parent page
    Show me how to embed this component in an existing Twig page and pass initial state.✓ Copied
    → Uses {{ component() }} helper correctly

Outcome: A working Live Component with proper LiveProp typing and no custom JS.

Pitfalls
  • Claude mixes Live Component and Twig Component concepts — Re-ask naming the package explicitly: 'use symfony/ux-live-component, not twig-component'
Combine with: filesystem · git

Refactor legacy JS into a Stimulus controller

👤 Developers modernizing a Symfony app's front-end ⏱ ~15 min beginner

When to use: Your app has jQuery or vanilla JS sprinkled in Twig — you want to move to Stimulus cleanly.

Prerequisites
  • Symfony UX + Stimulus configured (importmap or Webpack Encore) — symfony console importmap:require @hotwired/stimulus if missing
Flow
  1. Paste the legacy snippet and ask for a Stimulus conversion
    Convert this jQuery snippet to an idiomatic Stimulus controller with targets and values.✓ Copied
    → Controller with static targets, static values, clear actions
  2. Update the Twig template
    Show me the data-controller, data-*-target, and data-action attributes for the Twig side.✓ Copied
    → Correct data attributes, no inline handlers

Outcome: A clean Stimulus controller plus Twig wiring, ready to commit.

Pitfalls
  • Controller name mismatch between file and data-controller attribute — Remind Claude of the naming rule: hello_controller.js → data-controller=hello
Combine with: filesystem

Add Turbo-powered pagination without a page reload

👤 Symfony devs who want SPA-like UX with minimal JS ⏱ ~15 min intermediate

When to use: You have a paginated list and want Next/Prev to swap content in-place.

Flow
  1. Ask Claude to wrap the list in a Turbo Frame
    Wrap my paginated product list in a turbo-frame and make pagination links target that frame.✓ Copied
    → Uses <turbo-frame id=...> and frame-targeted links
  2. Handle the partial response
    Update the controller to render only the frame when the request has the Turbo-Frame header.✓ Copied
    → Controller checks request header and picks the right template

Outcome: Pagination swaps in-place with no full-page reload.

Pitfalls
  • Full page keeps reloading — Frame id on the link target must match frame id on the page — repeat it to Claude
Combine with: filesystem

Combinations

Pair with other MCPs for X10 leverage

symfony-ux-skill + filesystem

Claude reads your existing Twig/PHP and writes components matching codebase style

Read src/Entity/Product.php and src/Twig/Components/, then add a new LiveComponent for a product filter following the same patterns.✓ Copied
symfony-ux-skill + github

Open a PR with the new component once files are on disk

Commit the new LiveComponent files to a branch and open a PR titled 'Live product filter'.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
live-component-authoring component intent, props, actions You need a reactive UI piece in Symfony 0 — prompt-only
twig-component-authoring UI primitive description Reusable presentational block with no live server interactions 0
stimulus-controller-authoring behavior + targets/values Client-side interactivity that doesn't need the server 0
turbo-integration frame/stream intent Partial-page updates and form responses 0

Cost & Limits

What this costs to run

API quota
none — skill is local markdown
Tokens per call
adds ~2–8k tokens of context when the skill activates
Monetary
free, MIT-licensed
Tip
Keep the skill dir small — clone only the subskills you use if context-constrained

Security

Permissions, secrets, blast radius

Credential storage: none — no credentials needed
Data egress: none — pure instruction bundle, no network calls

Troubleshooting

Common errors and fixes

Skill doesn't activate

Confirm the directory is ~/.claude/skills/symfony-ux-skills/ and contains SKILL.md at the root. Restart Claude Code.

Verify: ls ~/.claude/skills/symfony-ux-skills/SKILL.md
Claude uses generic PHP instead of Symfony UX

Prompt explicitly: 'use the symfony-ux-skills you have loaded'

Generated code references UX packages you don't have installed

composer require the package, or tell Claude which packages are installed

Verify: composer show | grep symfony/ux

Alternatives

symfony-ux-skills vs others

AlternativeWhen to use it insteadTradeoff
sivalabs-agent-skillsYou work in Spring Boot instead of SymfonyDifferent stack entirely
claude-wordpress-skillsYou work in WordPress / PHP but not SymfonyWordPress-specific patterns, no Twig/Turbo

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills