Skip to content

wrsmith108/linear-claude-skill

Managing Linear issues, projects, and teams. Use when working with Linear tasks, creating issues, updating status, querying projects, or managing team workflows.

FileKindSize
SKILL.mdskill md22.7 KB
scripts/__tests__/bulk-create.test.tsscript5.0 KB
scripts/__tests__/issue-description.test.tsscript6.8 KB
scripts/__tests__/lin-cli.test.tsscript3.8 KB
scripts/__tests__/lint-issues.test.tsscript2.3 KB
scripts/__tests__/retry.test.tsscript8.2 KB
scripts/__tests__/smoke.test.tsscript7.0 KB
scripts/__tests__/validate-description.test.tsscript4.3 KB
scripts/build.mjsscript1.4 KB
scripts/bulk-create.tsscript12.5 KB
scripts/create-initiative-update.tsscript5.8 KB
scripts/create-issue-with-project.tsscript8.0 KB
scripts/create-project-update.tsscript5.5 KB
scripts/extract-image.tsscript2.2 KB
scripts/lib/agent-selection.tsscript8.7 KB
scripts/lib/exit-codes.tsscript357 B
scripts/lib/index.tsscript3.1 KB
scripts/lib/initiative.tsscript5.0 KB
scripts/lib/issue-description.tsscript7.1 KB
scripts/lib/labels.tsscript7.6 KB
scripts/lib/lin-cli.tsscript7.3 KB
scripts/lib/linear-utils.tsscript9.3 KB
scripts/lib/project-template.tsscript8.8 KB
scripts/lib/retry.tsscript4.8 KB
scripts/lib/taxonomy-data.tsscript8.1 KB
scripts/lib/taxonomy-validation.tsscript10.0 KB
scripts/lib/taxonomy.tsscript3.6 KB
scripts/lib/verify.tsscript6.6 KB
scripts/linear-api.mjsexecutablescript12.1 KB
scripts/linear-ops.tsscript69.1 KB
scripts/lint-issues.tsscript6.9 KB
scripts/phase-complete.tsscript12.4 KB
scripts/query.shexecutablescript498 B
scripts/query.tsscript3.5 KB
scripts/run.shexecutablescript321 B
scripts/setup.tsscript8.6 KB
scripts/sync-skill-version.mjsscript2.0 KB
scripts/sync.tsscript5.7 KB
scripts/upload-image.tsscript4.4 KB

scripts/lib/initiative.ts

View on GitHub
/**
 * Initiative Linking Utilities
 *
 * MANDATORY: Every project MUST be linked to an initiative.
 * This module ensures projects are properly connected.
 */
import { getLinearClient } from './linear-utils'

// Default initiative ID - set via environment or override in function calls
// Users should set LINEAR_DEFAULT_INITIATIVE_ID in their environment
export const DEFAULT_INITIATIVE_ID = process.env.LINEAR_DEFAULT_INITIATIVE_ID || ''

// Legacy export for backwards compatibility (deprecated)
export const INITIATIVES = {
  DEFAULT: DEFAULT_INITIATIVE_ID
} as const

/**
 * Link a project to an initiative using initiativeToProjectCreate mutation.
 *
 * This is the ONLY correct way to link projects. Do NOT use:
 * - projectUpdate with initiativeIds (doesn't exist)
 * - projectCreate with initiativeId (deprecated)
 */
export async function linkProjectToInitiative(
  projectId: string,
  initiativeId: string
): Promise<{ success: boolean; error?: string }> {
  try {
    const mutation = `
      mutation LinkProjectToInitiative($initiativeId: String!, $projectId: String!) {
        initiativeToProjectCreate(input: {
          initiativeId: $initiativeId,
          projectId: $projectId
        }) {
          success
          initiativeToProject {
            id
          }
        }
      }
    `

    const response = await fetch('https://api.linear.app/graphql', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': process.env.LINEAR_API_KEY || ''
      },
      body: JSON.stringify({
        query: mutation,
        variables: { initiativeId, projectId }
      })
    })

    const result = await response.json()

    if (result.errors) {
      // Check if already linked
      if (result.errors[0]?.message?.includes('already exists')) {
        return { success: true } // Already linked is fine
      }
      return { success: false, error: result.errors[0]?.message }
    }

    return { success: result.data?.initiativeToProjectCreate?.success === true }
  } catch (error) {
    return { success: false, error: String(error) }
  }
}

/**
 * Check if a project is linked to an initiative
 *
 * Note: Linear uses initiativeToProject edges, not a direct initiative field.
 * We query from the initiative side to find linked projects.
 */
export async function isProjectLinkedToInitiative(
  projectId: string,
  initiativeId: string
): Promise<boolean> {
  try {
    // Query initiative's projects to check if this project is linked
    const query = `
      query CheckInitiativeProjects($initiativeId: String!) {
        initiative(id: $initiativeId) {
          id
          projects {
            nodes {
              id
            }
          }
        }
      }
    `

    const response = await fetch('https://api.linear.app/graphql', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': process.env.LINEAR_API_KEY || ''
      },
      body: JSON.stringify({
        query,
        variables: { initiativeId }
      })
    })

    const result = await response.json()
    const projectIds = result.data?.initiative?.projects?.nodes?.map(
      (p: { id: string }) => p.id
    ) || []

    return projectIds.includes(projectId)
  } catch {
    return false
  }
}

/**
 * Get all projects and their initiative links
 */
export async function getProjectInitiativeStatus(): Promise<
  Array<{ id: string; name: string; initiative: string | null }>
> {
  const projects = await getLinearClient().projects()
  const results = []

  for (const proj of projects.nodes) {
    const initiatives = await proj.initiatives()
    const initiative = initiatives?.nodes?.[0]
    results.push({
      id: proj.id,
      name: proj.name,
      initiative: initiative?.name || null
    })
  }

  return results
}

/**
 * Link all projects matching a filter to an initiative
 *
 * @param initiativeId - The initiative to link projects to
 * @param projectFilter - Optional filter (e.g., { name: { contains: 'MyProject' } })
 */
export async function linkProjectsToInitiative(
  initiativeId: string,
  projectFilter?: { name?: { contains?: string; eq?: string } }
): Promise<{
  linked: string[]
  failed: string[]
  alreadyLinked: string[]
}> {
  if (!initiativeId) {
    throw new Error('initiativeId is required. Set LINEAR_DEFAULT_INITIATIVE_ID or pass explicitly.')
  }

  const projects = await getLinearClient().projects(projectFilter ? { filter: projectFilter } : undefined)

  const linked: string[] = []
  const failed: string[] = []
  const alreadyLinked: string[] = []

  for (const proj of projects.nodes) {
    // Check if already linked
    const isLinked = await isProjectLinkedToInitiative(proj.id, initiativeId)
    if (isLinked) {
      alreadyLinked.push(proj.name)
      continue
    }

    // Link to initiative
    const result = await linkProjectToInitiative(proj.id, initiativeId)
    if (result.success) {
      linked.push(proj.name)
    } else {
      failed.push(`${proj.name}: ${result.error}`)
    }
  }

  return { linked, failed, alreadyLinked }
}

planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall