Linear to Knowledge Base Synchronization

VerifiedSafe

Synchronizes Linear project state to a local knowledge base in two phases: a lightweight structural scan followed by a deep team-by-team sync. Useful for keeping local history of teams, initiatives, and milestones up to date without exhausting context.

Sby Skills Guide Bot
ProductivityIntermediate
606/2/2026
Claude Code
#linear#sync#knowledge-base#project-management

Recommended for

Our review

Synchronizes Linear project state to a local knowledge base using a two-phase process.

Strengths

  • Fully automates synchronization of projects, initiatives, and issues.
  • Two-phase approach to avoid exhausting context window.
  • Supports incremental per-team sync.
  • Consolidated summary with historical links.

Limitations

  • Requires Linear API access and prior configuration.
  • Sequential sync can be slow for many teams.
  • Depends on correct team IDs from the scan.
When to use it

Use this skill to keep a local knowledge base up-to-date with Linear project status, especially for regular reporting or a comprehensive overview.

When not to use it

Avoid if your team is small and manual updates suffice, or if you don't need a local knowledge base.

Security analysis

Safe
Quality score75/100

The skill only instructs to read from Linear and write to local knowledge base files; no destructive commands, exfiltration, or code execution is implied.

No concerns found

Examples

Full sync of all Linear teams
Sync all Linear projects to the knowledge base.
Sync a single team
Sync the Engineering team from Linear.

name: sync-linear description: "Sincronizar estado de proyectos de Linear a la base de conocimiento." disable-model-invocation: false

El usuario quiere sincronizar el estado de sus proyectos de Linear a la base de conocimiento local.

La sync se divide en dos fases para evitar agotar el contexto:

  1. linear-scan — escaneo estructural ligero (teams, iniciativas, proyectos). Sin issues.
  2. linear-team-sync — sync profundo de UN solo equipo (issues, milestones, snapshots).

Si $ARGUMENTS tiene nombre de equipo (ej: /sync-linear Accounting)

Lanza directamente linear-team-sync en modo standalone:

Task(subagent_type="linear-team-sync", prompt="
Sincroniza el equipo {$ARGUMENTS} en modo standalone.
- Equipo: {$ARGUMENTS}
- Fecha actual: {YYYY-MM-DD HH:MM}
- Modo: standalone
- Path historico: kb/gestion/linear/historico/{YYYY-MM-DD-HH-MM}.md
Busca el ID del equipo consultando Linear. Lee METADATA.md para contexto previo.
")

Muestra el resumen al terminar.


Si $ARGUMENTS esta vacio (sync completo)

Paso 1: Lanzar linear-scan

Task(subagent_type="linear-scan", prompt="
Escanea la estructura completa del workspace de Linear. Fecha actual: {YYYY-MM-DD HH:MM}.
Sincronizar todos los equipos.
")

Del resultado, extrae:

  • Lista de equipos con nombres e IDs (del bloque EQUIPOS)
  • Path del historico (del bloque HISTORICO)

Paso 2: Sync por equipo (secuencial)

Por CADA equipo de la lista, lanza linear-team-sync uno a la vez (secuencial, no en paralelo — cada uno consume contexto significativo):

Task(subagent_type="linear-team-sync", prompt="
Sincroniza el equipo {Team Name} de forma incremental.
- Equipo: {Team Name}
- ID del equipo: {team_id}
- Fecha actual: {YYYY-MM-DD HH:MM}
- Modo: full-sync
- Path historico: {path extraido del scan}
")

Colecta el resumen de cada equipo.

Paso 3: Mostrar resumen consolidado

Al terminar todos los equipos, muestra un resumen consolidado con:

  • Equipos sincronizados
  • Proyectos totales
  • Issues activos totales
  • Cambios mas relevantes por equipo
  • Link al historico
Related skills