linear-claude-skill MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Codifica el modelo de datos de Linear: Equipos → Proyectos → Ciclos → Problemas → Subproblemas
Fragmentos de consultas GraphQL listos para los reportes más comunes
Convenciones de prioridad, estado y etiquetas que el agente aplica consistentemente
Funciona junto al MCP oficial de Linear para escrituras
Skill solo en Markdown — sin dependencias de tiempo de ejecución que instalar

Demo en vivo

Cómo se ve en la práctica

linear-claude-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": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-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": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-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": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add linear-claude-skill -- git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill

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

Casos de uso

Usos del mundo real: linear-claude-skill

Cómo ejecutar una revisión semanal de ciclo de Linear con Claude

👤 Gerentes de ingeniería y líderes técnicos en un equipo de Linear ⏱ ~15 min beginner

Cuándo usarlo: Viernes por la tarde, necesitas saber qué se entregó este ciclo, qué se retrasó y qué llevar al siguiente.

Requisitos previos

Clave API de Linear o MCP de Linear instalado — linear.app/settings/api — crea una clave API personal
Skill clonada — git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill

Flujo

Pídele a Claude que traiga el ciclo actual

Muéstrame cada problema en el ciclo actual del equipo ENG — agrupado por estado, con el asignado.✓ Copiado

→ Tabla: Backlog / En Progreso / En Revisión / Hecho con IDs de problemas
Diagnostica retrasos

¿Qué problemas siguen En Progreso o En Revisión con 2 días restantes? ¿Quién es el responsable?✓ Copiado

→ Una línea por problema con aviso de riesgo
Traslada y escribe el resumen

Traslada problemas incompletos al siguiente ciclo y elabora un resumen de Slack de lo que realmente se entregó.✓ Copiado

→ Confirmación del traslado + resumen listo para pegar

Resultado: Un cierre de ciclo limpio en 10 minutos en lugar de una hora.

Errores comunes

Claude traslada problemas que querías cancelar — Dile 'lista primero, confirma, luego muta' — mantén un punto de control humano antes de escribir

Combinar con: github · slack

Triage la bandeja de entrada de bugs con fundamentación de priorización

👤 Ingenieros de guardia, líderes técnicos ⏱ ~25 min intermediate

Cuándo usarlo: Lunes por la mañana, el proyecto Bugs tiene 40 elementos sin triaje y necesitas reducir la lista.

Flujo

Lista bugs sin triaje

Encuentra todos los problemas en el proyecto 'Bugs' sin prioridad ni asignado, creados en los últimos 14 días.✓ Copiado

→ Tabla clasificada con títulos
Sugiere prioridad + propietario

Para cada uno, sugiere prioridad (Urgente/Alta/Media/Baja) y el equipo más probable basado en las rutas de archivo o etiquetas mencionadas.✓ Copiado

→ Sugerencias razonadas, no un Media genérico
Aplica las decisiones

Aplica esas prioridades y asigna a los equipos sugeridos. Confirma antes de cada escritura.✓ Copiado

→ Confirmación por problema

Resultado: Una bandeja de entrada de bugs completamente triada con razonamiento trazable por problema.

Errores comunes

Asignar en masa a una persona que aparece en los últimos commits — Limita las asignaciones a nivel de equipo, no individual — más barato de corregir después

Combinar con: github

Genera una actualización de estado del proyecto desde Linear

👤 PMs y TPMs ejecutando proyectos multi-ciclo ⏱ ~15 min beginner

Cuándo usarlo: Antes de una reunión de revisión de estado o actualización asincrónica a los interesados.

Flujo

Recopila el estado del proyecto

Resume el proyecto 'Mobile v2.0': recuentos de problemas por estado, % completo, y qué ha cambiado desde el lunes pasado.✓ Copiado

→ Captura numérica + delta
Señala riesgos

Lista los 3 principales riesgos — problemas bloqueados, vencidos o sin propietario.✓ Copiado

→ Riesgos clasificados con fundamentación
Redacta la actualización

Escribe una actualización de estado de 5 puntos: progreso, entregado esta semana, próxima semana, riesgos, solicitudes.✓ Copiado

→ Párrafo o puntos listos para pegar

Resultado: Una actualización concisa para los interesados que no tuviste que escribir tú mismo.

Errores comunes

Las actualizaciones se vuelven uniformemente 'en camino' — Fuerza a Claude a elegir riesgos reales de problemas obsoletos; no dejes que redondee a verde

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

linear-claude-skill + github

Espeja la actividad de problemas de GitHub en Linear para seguimiento

Para cada problema cerrado en octocat/api esta semana, marca el problema de Linear correspondiente como Hecho y deja un comentario vinculando al PR.✓ Copiado

linear-claude-skill + sentry

Archivar automáticamente bugs de Linear desde alertas de Sentry con prioridad adecuada

Para cada problema de Sentry marcado como 'sin resolver' con >100 eventos hoy, crea un bug de Linear en el equipo BACKEND con prioridad Alta.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
cycle-reporting	equipo, selector de ciclo	Necesitas una captura del estado de un ciclo	N llamadas a API de Linear (solo lectura)
issue-triage	filtro (proyecto, estado, etiquetas)	Limpieza semanal de bugs o backlog	Solo lectura hasta que el usuario confirme escrituras
issue-creation	título, descripción, equipo, prioridad, etiquetas	Archivar problemas estructurados de notas de reunión o eventos de Sentry/GitHub	1 escritura por problema
project-status	id del proyecto	Antes de actualizaciones de interesados	Solo lectura

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: API de Linear: 1500 solicitudes / hora en claves personales
Tokens por llamada: 200–2000 tokens por paso del reporte
Monetario: Gratis — Los planes Linear Free y Standard ambos soportan acceso a API
Consejo: Agrupa campos GraphQL en una consulta — ahorra tanto límite de velocidad como presupuesto de tokens

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: read

Almacenamiento de credenciales: Clave API de Linear en variable de entorno (LINEAR_API_KEY). Nunca pegues en el prompt.

Salida de datos: solo api.linear.app

No conceder nunca: admin (escritura a nivel de org)

Los problemas, proyectos y ciclos pueden contener información confidencial de hoja de ruta — piénsalo dos veces antes de pegar en herramientas externas.

Resolución de problemas

Errores comunes y soluciones

La skill no se activa

Asegúrate de que SKILL.md exista en ~/.claude/skills/linear-claude-skill/SKILL.md y reinicia Claude Code.

Verificar: ls ~/.claude/skills/linear-claude-skill/

401 de API de Linear

Regenera la clave API en linear.app/settings/api; asegúrate de que LINEAR_API_KEY esté exportada en el shell en que se ejecuta Claude Code.

Verificar: echo $LINEAR_API_KEY | head -c 6

Límite de velocidad alcanzado durante un reporte grande

Pídele a Claude que pagine con menos campos; o divide el reporte por equipo.

Alternativas

linear-claude-skill vs otros

Alternativa	Cuándo usarla	Contrapartida
Linear MCP (oficial)	Quieres una superficie de herramienta JSON-RPC en lugar de una skill de prompt	MCP proporciona herramientas reales; la skill proporciona mejores valores por defecto y prosa de reporte
Skill de Jira	Tu equipo usa Jira en lugar de Linear	Modelo de datos completamente diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills