/ Directorio / Playground / claude-code_rails-upgrade-skill
← Todos los servidores ↗ GitHub
● Comunidad ombulabs ⚡ Instantáneo

claude-code_rails-upgrade-skill

por ombulabs · ombulabs/claude-code_rails-upgrade-skill

Skill de Claude Code que actualiza Rails metódicamente — desde la auditoría, pasando por las correcciones de deprecación hasta bundle update — sin romper nada.

Rails Upgrade Skill (por OmbuLabs) guía a Claude a través del proceso estándar de actualización de Rails: auditar el código, corregir deprecaciones, aplicar valores predeterminados del framework, manejar incompatibilidades de gemas y verificar en la nueva versión. Basado en la experiencia de producción de OmbuLabs actualizando aplicaciones Rails. Ideal para pasar de la versión N a N+1, o ponerse al día desde versiones antiguas.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

claude-code-rails-upgrade-skill.replay ▶ listo
0/0

Instalar

Elige tu cliente

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-code-rails-upgrade-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-code-rails-upgrade-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
          "~/.claude/skills/claude-code_rails-upgrade-skill"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add claude-code-rails-upgrade-skill -- git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/claude-code_rails-upgrade-skill

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: claude-code_rails-upgrade-skill

Cómo planificar una actualización de Rails antes de tocar código

👤 Desarrolladores Rails que enfrentan un salto entre múltiples versiones ⏱ ~60 min intermediate

Cuándo usarlo: Estás en Rails 6.1 y necesitas llegar a 7.2. Quieres un plan sólido, no improvisar.

Requisitos previos
  • Skill instalado — git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/rails-upgrade-skill
  • Árbol de trabajo git limpio — Siempre actualiza en una rama; confirma el estado actual
Flujo
  1. Auditar estado actual
    Audita esta aplicación Rails: versión actual, versión de Ruby, gemas, advertencias de deprecación de una ejecución de tests.✓ Copiado
    → Informe de referencia
  2. Construir la ruta
    Planifica la actualización a Rails 7.2. Avanza versión por versión (6.1 → 7.0 → 7.1 → 7.2), cada una con criterios de hito.✓ Copiado
    → Plan multietapa
  3. Identificar bloqueadores
    ¿Qué gemas no tienen una versión compatible con 7.2? Propuestas para cada una (actualizar/reemplazar/fork).✓ Copiado
    → Lista de bloqueadores por gema

Resultado: Un plan de actualización realista con hitos por etapas.

Errores comunes
  • Saltar dos versiones principales a la vez — Skill hace cumplir una versión menor/principal a la vez — no lo anules

Buscar y corregir advertencias de deprecación

👤 Desarrolladores Rails en medio de una actualización ⏱ ~90 min intermediate

Cuándo usarlo: Estás entre versiones y la ejecución de tests es un muro de advertencias de deprecación.

Flujo
  1. Recopilar
    Ejecuta tests, recopila todas las advertencias de deprecación únicas.✓ Copiado
    → Lista deduplicada con ocurrencias archivo:línea
  2. Agrupar + corregir
    Agrupa por causa. Propone correcciones mínimas con diffs para cada grupo.✓ Copiado
    → Diffs de correcciones agrupadas

Resultado: Una ejecución de tests limpia lista para el siguiente aumento de versión.

Aplicar nuevos valores predeterminados del framework de forma segura

👤 Desarrolladores Rails navegando rails app:update ⏱ ~60 min advanced

Cuándo usarlo: Has actualizado el Gemfile y ejecutado rails app:update; ahora tienes un montón de inicializadores nuevos.

Flujo
  1. Revisar diff
    Revisa el diff de rails app:update. Marca cualquier cambio de valor predeterminado que podría romper nuestra app (strict_loading, modo zeitwerk, etc.).✓ Copiado
    → Anotación de riesgo por cambio
  2. Habilitar por etapas
    Para cada valor predeterminado riesgoso, produce un despliegue por etapas: habilita detrás de una bandera env, valida en staging, luego activa.✓ Copiado
    → Plan por etapas por valor predeterminado

Resultado: Valores predeterminados habilitados sin regresiones sorpresa.

Errores comunes
  • Habilitar todos los load_defaults a la vez — Usa new_framework_defaults_X.Y.rb para aumentar individualmente

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-code-rails-upgrade-skill + claude-code-owasp-skill

Revisión de seguridad en el código actualizado

Después de actualizar a Rails 7.2, ejecuta revisión OWASP en la autenticación y manejo de parámetros.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
Audit repositorio Inicio de cada actualización tokens de Claude
Plan upgrade path actual, destino Después de la auditoría tokens de Claude
Gem compat check Gemfile, Rails destino Antes de actualizar tokens de Claude + RubyGems API
Deprecation sweep registro de test Entre versiones tokens de Claude
Framework defaults migration diff de rails app:update Después de rails app:update tokens de Claude

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno
Tokens por llamada
20-80k a lo largo de una actualización
Monetario
Gratis
Consejo
Ejecuta búsquedas de deprecación en directorios específicos en lugar de toda la app a la vez.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales
Salida de datos: Código enviado a Claude para inferencia

Resolución de problemas

Errores comunes y soluciones

rails app:update genera archivos binarios sin confirmar

Estos suelen ser archivos de sistema. Añádelos a .gitignore y regenera limpiamente.

Los tests pasan localmente, fallan en CI después de actualizar

Probablemente diferencias en autoloading o eager_load en modo producción. Ejecuta con RAILS_ENV=production localmente.

La resolución del bundle de gemas falla

Skill sugerirá versiones alternativas de gemas; a veces se requiere un fork o reemplazo.

Verificar: bundle update --conservative

Alternativas

claude-code_rails-upgrade-skill vs otros

AlternativaCuándo usarlaContrapartida
next_rails gemQuieres un helper de actualización deterministaSin correcciones de deprecación guiadas por LLM

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills