linear

Descripción general de la skill linear

La skill linear te ayuda a trabajar con Linear a través del servidor Linear MCP, de modo que un agente pueda leer, crear y actualizar issues sin tener que adivinar la estructura del workspace ni las convenciones del flujo de trabajo. Es especialmente útil para quienes necesitan linear para Issue Tracking, triaje, coordinación de proyectos o para mantener el trabajo del equipo alineado con el estado real de los issues.

Para qué sirve esta skill linear

Usa esta skill linear cuando la tarea dependa de datos precisos de Linear: encontrar el issue correcto, actualizar el estado, añadir contexto, asignar responsables o comprobar el avance de un proyecto. Es mejor que un prompt genérico cuando necesitas que el agente trabaje dentro de un workspace real de Linear en lugar de redactar una recomendación aislada.

Quién debería instalarla

Instala linear si ya usas Linear para el seguimiento de issues y quieres que un agente te ayude con trabajo operativo: colas de triaje, higiene de tickets, seguimiento de proyectos o coordinación entre equipos. Encaja especialmente bien con usuarios que valoran la corrección del flujo de trabajo, no solo la generación de mensajes.

Factores clave para decidir

La dependencia principal es el acceso: la skill requiere un servidor Linear MCP conectado y autenticación OAuth. Si tu workspace, equipos o proyectos tienen restricciones, la adopción puede quedarse bloqueada hasta confirmar los permisos. El mayor valor es un uso fiable y contextual de Linear; el mayor riesgo es asumir que la skill puede actuar antes de que MCP esté configurado.

Cómo usar la skill linear

Instala y conecta Linear MCP

Para instalar linear, añade la skill y conecta el servidor MCP antes de esperar resultados:

codex mcp add linear --url https://mcp.linear.app/mcp
codex --enable rmcp_client
codex mcp login linear

Si el inicio de sesión funciona, reinicia Codex antes de continuar. Si hay problemas de conexión en Windows, el transporte MCP basado en WSL puede ser el camino más rápido hacia una configuración funcional.

Dale a la skill la forma de tarea adecuada

El mejor uso de linear empieza con una acción concreta, no con un objetivo vago. Las buenas indicaciones nombran el objeto y el cambio deseado: “Busca el informe de bug sobre fallos de inicio de sesión, muévelo a In Progress y resume los bloqueos”, o “Crea un issue de Linear para la documentación de onboarding con responsable, prioridad y criterios de aceptación”. Evita prompts como “organiza Linear” salvo que también especifiques el alcance, el equipo y qué salida quieres.

Lee primero estos archivos

Empieza por SKILL.md y después revisa agents/openai.yaml para ver la intención por defecto y la dependencia de MCP. Consulta también LICENSE.txt para el contexto de reutilización y los archivos de assets solo si necesitas branding. El detalle operativo más importante es el flujo de trabajo obligatorio en SKILL.md, especialmente los pasos de configuración y aclaración.

Consejos de flujo de trabajo que mejoran los resultados

Cuando quieras que el modelo actúe en Linear, indica el workspace, el equipo, el proyecto y si la petición es de solo lectura o modifica datos. Si necesitas actualizar issues, incluye los cambios exactos que quieres en cada campo, además de restricciones como prioridad, fecha de vencimiento o asignado. Si la conexión MCP no está lista, la skill debería detenerse y ayudarte a completar la configuración antes de seguir.

Preguntas frecuentes sobre la skill linear

¿linear sirve solo para Issue Tracking?

No. linear para Issue Tracking es el caso más común, pero la skill también encaja con actualizaciones de proyectos, coordinación de equipos y tareas de flujo de trabajo vinculadas a documentación dentro de Linear. Úsala siempre que la fuente de verdad esté en Linear y el resultado tenga que reflejar el estado real del workspace.

¿Qué diferencia hay entre la skill linear y un prompt normal?

Un prompt normal puede describir lo que debería pasar; la skill linear está pensada para hacerlo sobre un workspace de Linear conectado. Eso importa cuando necesitas IDs reales de issues, estado actual, permisos o actualizaciones fiables en lugar de un plan solo en texto.

¿Es apta para principiantes?

Sí, si puedes nombrar la tarea con claridad y ya tienes acceso a Linear. Es menos apta para principiantes si todavía estás decidiendo qué equipo, proyecto o issue debe cambiarse, porque las mejores entradas para linear son específicas.

¿Cuándo no debería usarla?

No uses linear si solo necesitas una plantilla genérica de gestión de proyectos, si tu workspace de Linear no está conectado o si la tarea debe quedar fuera de tu gestor de issues. Tampoco es la opción adecuada cuando necesitas ideación amplia sin ninguna acción real en Linear.

Cómo mejorar la skill linear

Aporta más contexto de Linear

Las mejores entradas para linear incluyen el workspace, el equipo, el proyecto, el título o enlace del issue y la operación exacta. Si quieres un mejor resultado de triaje, añade síntomas, pistas de prioridad y cualquier referencia a issues relacionados para que el agente pueda desambiguar rápido.

Indica el estado final deseado

En lugar de pedir “ayuda con este issue”, di cómo debería quedar el issue de Linear al terminar la tarea: estado cambiado, responsable asignado, descripción reescrita, criterios de aceptación añadidos o duplicados fusionados. Las instrucciones claras sobre el resultado final reducen el ida y vuelta y hacen más predecible el uso de Linear.

Vigila los fallos de configuración y permisos

El modo de fallo más habitual no es el prompt, sino la falta de acceso a MCP o permisos insuficientes en el workspace. Si la skill no puede conectar, corrige primero la configuración de Linear MCP; si puede conectar pero no actuar, verifica los permisos del equipo y del proyecto relevantes antes de volver a intentarlo.

Itera con prompts más precisos después del primer intento

Si el primer resultado es demasiado amplio, acótalo añadiendo un issue, un equipo o un proyecto cada vez. Para trabajos repetidos, reutiliza un patrón de prompt estable que incluya el tipo de tarea, el alcance y los criterios de éxito para que la skill linear pueda generar actualizaciones coherentes con menos edición.