craftcms-claude-skills MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Skill bundle for Craft CMS 5.x (PHP 8.2+) specifics
Templates for modules, plugins, custom fields
Twig template scaffolding that matches Craft idioms
Database migration patterns using Craft's MigrationHelper
GraphQL schema helpers for headless Craft projects

Demo ao vivo

Como fica na prática

craftcms-claude-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "craftcms-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "craftcms-claude-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/michtio/craftcms-claude-skills",
        "~/.claude/skills/craftcms-claude-skills"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "craftcms-claude-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/michtio/craftcms-claude-skills",
          "~/.claude/skills/craftcms-claude-skills"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add craftcms-claude-skill -- git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: craftcms-claude-skills

Scaffold a custom Craft CMS module without leaving Claude Code

👤 Craft CMS developers building site-specific modules ⏱ ~30 min intermediate

Quando usar: You need a new module and don't want to hand-copy another one as a template.

Pré-requisitos

Craft CMS 5 project set up locally — composer create-project craftcms/craft my-project
Skill cloned — git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills

Fluxo

Describe the module's job

Use craftcms-claude-skills. Create a new module called 'Inventory' that registers a custom element type for warehouse items.✓ Copiado

→ Claude scaffolds modules/inventory/ with src/Inventory.php, elements/WarehouseItem.php, and a config entry
Wire it up

Register the module in config/app.php and add the bootstrap entry.✓ Copiado

→ Config diff shown; module loads without errors on craft setup/check
Add an element query

Add a WarehouseItemQuery class with a custom 'sku' parameter that filters on the content table.✓ Copiado

→ Query class with proper WHERE clauses, not raw SQL soup

Resultado: A working Craft module that follows Pixel & Tonic conventions — ready for your first migration.

Armadilhas

Claude writes Craft 3/4 style code — Explicitly state Craft CMS 5 in every prompt — the API surface changed

Combine com: filesystem · mysql

Refactor a mess of Twig templates into idiomatic Craft

👤 Front-end devs inheriting a Craft site with sketchy templates ⏱ ~45 min intermediate

Quando usar: You took over a Craft project and the templates are full of raw SQL, inline PHP, and cache tags that don't work.

Fluxo

Point Claude at the worst template

Using craftcms-claude-skills, review templates/_entries/blog.twig and rewrite it using proper element queries and {% cache %} tags.✓ Copiado

→ Refactored template with craft.entries, section handle, and correct cache scoping
Extract reusable macros

Pull the card markup into a macro in _macros/cards.twig and include it properly.✓ Copiado

→ Macro file created; includes use {% from %} syntax

Resultado: Templates that load faster and future devs can actually read.

Armadilhas

Cache tags wrap dynamic user data and show wrong content — Use {% cache %} with globally keyed variations, never around authenticated user data

Combine com: filesystem

Write a safe Craft migration for content model changes

👤 Craft devs shipping schema changes to production ⏱ ~30 min advanced

Quando usar: You're adding a new field or restructuring an existing one and need a migration that won't eat data.

Fluxo

Describe the change

Use craftcms-claude-skills. Write a Craft migration that adds a 'featuredAt' datetime field to the News section, with a safe backfill from postDate.✓ Copiado

→ Migration file with safeUp / safeDown; uses Craft's Fields service, not raw schema hacks
Dry-run in dev

Walk me through testing this with ./craft migrate/up --interactive=0 on a staging copy first.✓ Copiado

→ Step-by-step checklist including DB backup

Resultado: A migration you can ship on a Friday without panic.

Armadilhas

Forgetting to register the field type in project config — Always run craft project-config/write after the migration and commit the YAML

Combine com: mysql · git

Combinações

Combine com outros MCPs para 10× de alavancagem

craftcms-claude-skill + filesystem

Skill provides Craft patterns; filesystem lets Claude actually apply them in your project

Apply the craftcms-claude-skills module scaffold to my current project directory.✓ Copiado

craftcms-claude-skill + mysql

Inspect Craft's content tables while writing migrations

Show me the current schema of the elements_sites table before I write this migration.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
module_scaffold	module name, element types	Starting a new module
field_generator	field name, type, handle	Adding a custom field type
twig_refactor	template path	Cleaning up legacy templates

Custo e limites

O que custa rodar

Cota de API: None
Tokens por chamada: Moderate — reference files load on demand
Monetário: Free
Dica: Reference the skill by name only when working on Craft code; it adds context overhead to unrelated tasks.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials

Saída de dados: None — local prompts and files only

Generated code targets Craft 5; do not apply to Craft 3/4 projects without review.

Solução de problemas

Erros comuns e correções

Claude generates Craft 3-era code (craft()->elements)

Mention 'Craft CMS 5' explicitly; the API namespace is craft\elements in 5.x

Verificar: grep -r 'craft()->' src/ should return nothing in Craft 5 code

Migration runs but field doesn't appear in CP

Run ./craft project-config/write and ./craft project-config/apply — project config drift is the usual cause

Verificar: ./craft project-config/diff

Skill not triggered on Craft prompts

Invoke by name: 'use craftcms-claude-skills'. Check SKILL.md is present.

Verificar: ls ~/.claude/skills/craftcms-claude-skills/SKILL.md

Alternativas

craftcms-claude-skills vs. outros

Alternativa	Quando usar	Troca
Raw Claude Code	Simple Twig-only tweaks that don't need Craft-specific idioms	Generic PHP suggestions, often wrong for Craft
symfony-hexagonal-skill	You're on Symfony, not Craft	Different framework conventions

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills