openai/skills

linear

Lee primero el contexto de Linear y después planifica y verifica las acciones autorizadas sobre incidencias y proyectos.

Ver código fuente

Descripción detallada

El Linear Skill del antiguo repositorio skills de OpenAI organiza el trabajo mediante una conexión Linear MCP disponible: aclarar equipo, proyecto y objetivo, leer incidencias o documentos y después agrupar las acciones necesarias. Una petición como «preparar la siguiente iteración» debe concretarse en trabajo existente, estados, prioridades, responsables y alcance de los cambios. El paquete aporta instrucciones y recursos de interfaz; los datos accesibles y las operaciones posibles proceden del servicio Linear realmente conectado.

El README de la revisión fijada declara expresamente obsoleto ese antiguo repositorio skills y remite a OpenAI Plugins para los ejemplos actuales. El documento de Linear sigue sirviendo para entender el flujo de leer el contexto antes de actuar, pero sus comandos de instalación y opciones del cliente pertenecen a un ejemplo histórico. La configuración actual debe contrastarse con la documentación oficial del entorno utilizado. Guardar el Skill no conecta un espacio de trabajo ni amplía los permisos de la cuenta.

Qué preparar

  • Una conexión Linear disponible en el entorno actual y acceso al espacio de trabajo de destino.
  • Equipo o proyecto, identificadores de las incidencias relevantes y alcance de la tarea.
  • Acciones permitidas y estados, etiquetas, responsables y fechas que deben comprobarse.

Resultados esperados

  • Una organización de incidencias, propuestas de agrupación o un plan de proyecto basado en el contexto existente.
  • Resultados de operaciones autorizadas e indicación de pasos pendientes o bloqueados.

Cómo utilizarlo

  1. Confirma espacio, equipo o proyecto y distingue una petición de análisis de otra que incluye modificaciones.
  2. Lee incidencias, definiciones de estados, etiquetas, documentos y contexto del proyecto antes de actuar.
  3. Agrupa los pasos por objetivo, comprueba identificadores y campos permitidos y usa la conexión real solo para las acciones autorizadas.
  4. Vuelve a leer los elementos afectados y presenta por separado cambios realizados, propuestas, pasos pendientes y obstáculos.

Límites y comprobaciones

  • Comprueba identificadores de equipo y proyecto: el mismo nombre puede existir en espacios distintos.
  • Busca incidencias existentes antes de crear otra y contrasta asignaciones, prioridades y etiquetas con la petición.
  • No interpretes los ejemplos del Skill como permiso para comentar o modificar un proyecto.
  • Sigue la documentación oficial actual de conexión del entorno; las antiguas opciones de Codex son material histórico.

Preguntas frecuentes

¿Instalar el Skill ya conecta Linear?

El paquete describe un flujo y declara una dependencia Linear MCP. Conexión, autenticación y derechos sobre el espacio de destino son requisitos independientes; guardar el archivo de instrucciones no los satisface.

¿Los comandos de la fuente son un tutorial actual de configuración?

El README fijado señala que el antiguo repositorio está obsoleto y remite a ejemplos de plugins actuales. Los comandos se conservan como fuente histórica; la configuración debe verificarse en la documentación del entorno concreto.

¿Qué actividades organiza este Skill?

La fuente trata clasificación de incidencias, planificación de iteraciones y versiones, revisión documental y distribución del trabajo. Las acciones disponibles dependen de la conexión real, los permisos de la cuenta y la petición confirmada.

Instalar este Skill

Añade este Skill desde su fuente verificada en GitHub con la Skills CLI.

npx skills add https://github.com/openai/skills --skill linear

Información de la fuente

Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Linear

Overview

This skill provides a structured workflow for managing issues, projects & team workflows in Linear. It ensures consistent integration with the Linear MCP server, which offers natural-language project management for issues, projects, documentation, and team collaboration.

Prerequisites

  • Linear MCP server must be connected and accessible via OAuth
  • Confirm access to the relevant Linear workspace, teams, and projects

Required Workflow

Follow these steps in order. Do not skip steps.

Step 0: Set up Linear MCP (if not already configured)

If any MCP call fails because Linear MCP is not connected, pause and set it up:

  1. Add the Linear MCP:
  • codex mcp add linear --url https://mcp.linear.app/mcp
  1. Enable remote MCP client:
  • Set [features] rmcp_client = true in config.toml or run codex --enable rmcp_client
  1. Log in with OAuth:
  • codex mcp login linear

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

Windows/WSL note: If you see connection errors on Windows, try configuring the Linear MCP to run via WSL:

json
{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}

Step 1

Clarify the user's goal and scope (e.g., issue triage, sprint planning, documentation audit, workload balance). Confirm team/project, priority, labels, cycle, and due dates as needed.

Step 2

Select the appropriate workflow (see Practical Workflows below) and identify the Linear MCP tools you will need. Confirm required identifiers (issue ID, project ID, team key) before calling tools.

Step 3

Execute Linear MCP tool calls in logical batches:

  • Read first (list/get/search) to build context.
  • Create or update next (issues, projects, labels, comments) with all required fields.
  • For bulk operations, explain the grouping logic before applying changes.

Step 4

Summarize results, call out remaining gaps or blockers, and propose next actions (additional issues, label changes, assignments, or follow-up comments).

Available Tools

Issue Management: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Project & Team: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Documentation & Collaboration: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Practical Workflows

  • Sprint Planning: Review open issues for a target team, pick top items by priority, and create a new cycle (e.g., "Q1 Performance Sprint") with assignments.
  • Bug Triage: List critical/high-priority bugs, rank by user impact, and move the top items to "In Progress."
  • Documentation Audit: Search documentation (e.g., API auth), then open labeled "documentation" issues for gaps or outdated sections with detailed fixes.
  • Team Workload Balance: Group active issues by assignee, flag anyone with high load, and suggest or apply redistributions.
  • Release Planning: Create a project (e.g., "v2.0 Release") with milestones (feature freeze, beta, docs, launch) and generate issues with estimates.
  • Cross-Project Dependencies: Find all "blocked" issues, identify blockers, and create linked issues if missing.
  • Automated Status Updates: Find your issues with stale updates and add status comments based on current state/blockers.
  • Smart Labeling: Analyze unlabeled issues, suggest/apply labels, and create missing label categories.
  • Sprint Retrospectives: Generate a report for the last completed cycle, note completed vs. pushed work, and open discussion issues for patterns.

Tips for Maximum Productivity

  • Batch operations for related changes; consider smart templates for recurring issue structures.
  • Use natural queries when possible ("Show me what John is working on this week").
  • Leverage context: reference prior issues in new requests.
  • Break large updates into smaller batches to avoid rate limits; cache or reuse filters when listing frequently.

Troubleshooting

  • Authentication: Clear browser cookies, re-run OAuth, verify workspace permissions, ensure API access is enabled.
  • Tool Calling Errors: Confirm the model supports multiple tool calls, provide all required fields, and split complex requests.
  • Missing Data: Refresh token, verify workspace access, check for archived projects, and confirm correct team selection.
  • Performance: Remember Linear API rate limits; batch bulk operations, use specific filters, or cache frequent queries.

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
openai
Oficial

security-best-practices

Perform language and framework specific security best-practice reviews and suggest improvements. Trigger only when the user explicitly requests security best practices guidance, a security review/report, or secure-by-default coding help. Trigger only for supported languages (python, javascript/typescript, go). Do not trigger for general code review, debugging, or non-security tasks.

Instalaciones / 1h
6
GitHub Stars
28,8 mil
Actualizado
28 oct
openai
Oficial

security-threat-model

Repository-grounded threat modeling that enumerates trust boundaries, assets, attacker capabilities, abuse paths, and mitigations, and writes a concise Markdown threat model. Trigger only when the user explicitly asks to threat model a codebase or path, enumerate threats/abuse paths, or perform AppSec threat modeling. Do not trigger for general architecture summaries, code review, or non-security design work.

Instalaciones / 1h
1
GitHub Stars
28,8 mil
Actualizado
28 oct
openai
Oficial

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

Instalaciones / 1h
2
GitHub Stars
28,8 mil
Actualizado
28 oct
openai
Oficial

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established ic

Instalaciones / 1h
2
GitHub Stars
28,7 mil
Actualizado
28 oct