● Comunidad
wrsmith108
⚡ Instantáneo
linear-claude-skill
por wrsmith108 · wrsmith108/linear-claude-skill
Una skill de Claude que enseña al agente cómo gestionar problemas de Linear, proyectos y ciclos a través del MCP y SDK de Linear.
Clona esta skill en ~/.claude/skills/ y Claude obtiene un modelo mental funcional de Linear — equipos, ciclos, estados de problemas, consultas GraphQL y automatizaciones comunes. Envuelve el MCP de Linear (o llamadas directas al SDK) con patrones opinados para que el agente haga triaje, traslados y reportes de proyectos sin reinventar la API cada vez.
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
Casos de uso
Usos del mundo real: linear-claude-skill
Cuándo usarlo: Viernes por la tarde, necesitas saber qué se entregó este ciclo, qué se retrasó y qué llevar al siguiente.
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
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
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
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
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
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
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
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 |