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/taxonomy-data.ts

View on GitHub
/**
 * Label Taxonomy Data
 *
 * Complete label definitions for the domain-based taxonomy system.
 * Each label includes:
 * - Human-readable description (for Linear's Triage Intelligence)
 * - Color (for visual consistency)
 * - Agent mappings (for self-selection routing)
 */

import type {
  LabelTaxonomy,
  LabelDefinition,
  DomainLabel,
  TypeLabel,
  ScopeLabel,
  TaxonomyLabel
} from './taxonomy'

/**
 * Domain Labels - Technical area for agent routing
 *
 * These labels drive which agents pick up work.
 * Each has primary agents (first choice) and secondary agents (backup).
 */
const DOMAIN_LABELS: Record<DomainLabel, LabelDefinition> = {
  security: {
    name: 'security',
    category: 'domain',
    description: 'Security vulnerabilities, authentication, encryption, access control',
    color: '#D73A4A',
    primaryAgents: ['security-manager', 'byzantine-coordinator'],
    secondaryAgents: ['reviewer', 'tester']
  },
  performance: {
    name: 'performance',
    category: 'domain',
    description: 'Performance optimization, benchmarking, latency, profiling',
    color: '#FBCA04',
    primaryAgents: ['performance-benchmarker', 'perf-analyzer'],
    secondaryAgents: ['coder', 'reviewer']
  },
  infrastructure: {
    name: 'infrastructure',
    category: 'domain',
    description: 'CI/CD, deployment, Docker, cloud, DevOps tooling',
    color: '#0E8A16',
    primaryAgents: ['swarm-init', 'mesh-coordinator'],
    secondaryAgents: ['coder', 'planner']
  },
  testing: {
    name: 'testing',
    category: 'domain',
    description: 'Test coverage, test infrastructure, QA automation',
    color: '#1D76DB',
    primaryAgents: ['tester', 'tdd-london-swarm'],
    secondaryAgents: ['reviewer']
  },
  reliability: {
    name: 'reliability',
    category: 'domain',
    description: 'Fault tolerance, consensus, distributed systems',
    color: '#5319E7',
    primaryAgents: ['raft-manager', 'gossip-coordinator'],
    secondaryAgents: ['tester']
  },
  core: {
    name: 'core',
    category: 'domain',
    description: 'Core business logic and system functionality',
    color: '#0075CA',
    primaryAgents: ['coder', 'sparc-coder'],
    secondaryAgents: ['reviewer', 'tester']
  },
  frontend: {
    name: 'frontend',
    category: 'domain',
    description: 'UI/UX, React, CSS, user-facing components',
    color: '#10B981',
    primaryAgents: ['frontend-dev', 'ui-designer'],
    secondaryAgents: ['reviewer', 'tester']
  },
  backend: {
    name: 'backend',
    category: 'domain',
    description: 'Server-side logic, APIs, database operations',
    color: '#1D76DB',
    primaryAgents: ['backend-dev', 'api-designer'],
    secondaryAgents: ['reviewer', 'tester']
  },
  integration: {
    name: 'integration',
    category: 'domain',
    description: 'Third-party APIs, external service integrations',
    color: '#7057FF',
    primaryAgents: ['integration-specialist'],
    secondaryAgents: ['coder', 'reviewer']
  },
  documentation: {
    name: 'documentation',
    category: 'domain',
    description: 'Docs, guides, API documentation, comments',
    color: '#0075CA',
    primaryAgents: ['researcher'],
    secondaryAgents: ['reviewer']
  },
  mcp: {
    name: 'mcp',
    category: 'domain',
    description: 'Model Context Protocol tools and servers',
    color: '#006B75',
    primaryAgents: ['mcp-developer', 'tool-builder'],
    secondaryAgents: ['coder', 'reviewer']
  },
  cli: {
    name: 'cli',
    category: 'domain',
    description: 'Command-line interfaces and terminal tools',
    color: '#E99695',
    primaryAgents: ['cli-developer'],
    secondaryAgents: ['coder', 'tester']
  },
  neural: {
    name: 'neural',
    category: 'domain',
    description: 'AI/ML components, neural networks, inference',
    color: '#D4C5F9',
    primaryAgents: ['safla-neural', 'collective-intelligence'],
    secondaryAgents: ['researcher', 'coder']
  }
}

/**
 * Type Labels - Work classification
 *
 * Exactly one type label is required per issue.
 * These define the nature of the work being done.
 */
const TYPE_LABELS: Record<TypeLabel, LabelDefinition> = {
  feature: {
    name: 'feature',
    category: 'type',
    description: 'New functionality or capability being added',
    color: '#A2EEEF'
  },
  bug: {
    name: 'bug',
    category: 'type',
    description: 'Defect causing incorrect behavior that needs fixing',
    color: '#D73A4A'
  },
  refactor: {
    name: 'refactor',
    category: 'type',
    description: 'Code improvement without changing external behavior',
    color: '#D4C5F9'
  },
  chore: {
    name: 'chore',
    category: 'type',
    description: 'Maintenance, dependencies, tooling updates',
    color: '#FEF2C0'
  },
  spike: {
    name: 'spike',
    category: 'type',
    description: 'Research, investigation, or prototyping task',
    color: '#FBCA04'
  }
}

/**
 * Scope Labels - Impact flags
 *
 * Optional labels (0-2 per issue) that flag special conditions.
 */
const SCOPE_LABELS: Record<ScopeLabel, LabelDefinition> = {
  'breaking-change': {
    name: 'breaking-change',
    category: 'scope',
    description: 'Changes that break backward compatibility',
    color: '#B60205'
  },
  'tech-debt': {
    name: 'tech-debt',
    category: 'scope',
    description: 'Technical debt that should be addressed',
    color: '#5319E7'
  },
  blocked: {
    name: 'blocked',
    category: 'scope',
    description: 'Work blocked by external dependency',
    color: '#D73A4A'
  },
  'needs-split': {
    name: 'needs-split',
    category: 'scope',
    description: 'Issue too large and needs breakdown',
    color: '#FBCA04'
  },
  'good-first-issue': {
    name: 'good-first-issue',
    category: 'scope',
    description: 'Suitable for newcomers to the codebase',
    color: '#7057FF'
  },
  enterprise: {
    name: 'enterprise',
    category: 'scope',
    description: 'Enterprise-tier specific feature',
    color: '#7057FF'
  },
  soc2: {
    name: 'soc2',
    category: 'scope',
    description: 'SOC2 compliance requirement',
    color: '#0052CC'
  }
}

/**
 * Complete Label Taxonomy
 *
 * The authoritative source for all taxonomy labels.
 */
export const LABEL_TAXONOMY: LabelTaxonomy = {
  domain: DOMAIN_LABELS,
  type: TYPE_LABELS,
  scope: SCOPE_LABELS
}

/**
 * Get all taxonomy labels as a flat array
 */
export function getAllLabels(): LabelDefinition[] {
  return [
    ...Object.values(DOMAIN_LABELS),
    ...Object.values(TYPE_LABELS),
    ...Object.values(SCOPE_LABELS)
  ]
}

/**
 * Get all taxonomy label names
 */
export function getAllLabelNames(): TaxonomyLabel[] {
  return getAllLabels().map(l => l.name)
}

/**
 * Get a label by name (case-insensitive)
 */
export function getLabelByName(name: string): LabelDefinition | undefined {
  const normalizedName = name.toLowerCase().trim()
  return getAllLabels().find(l => l.name === normalizedName)
}

/**
 * Check if a label name is in the taxonomy
 */
export function isValidLabel(name: string): boolean {
  return getLabelByName(name) !== undefined
}

/**
 * Get labels by category
 */
export function getLabelsByCategory(category: 'domain' | 'type' | 'scope'): LabelDefinition[] {
  switch (category) {
    case 'domain':
      return Object.values(DOMAIN_LABELS)
    case 'type':
      return Object.values(TYPE_LABELS)
    case 'scope':
      return Object.values(SCOPE_LABELS)
  }
}

/**
 * Get color for a label (for creating in Linear)
 * Falls back to default gray if not found
 */
export function getLabelColor(name: string): string {
  const label = getLabelByName(name)
  return label?.color || '#6B7280'
}

/**
 * Build a lookup map of label name -> color
 * Useful for batch operations
 */
export function buildColorMap(): Record<string, string> {
  const map: Record<string, string> = {}
  for (const label of getAllLabels()) {
    map[label.name] = label.color
  }
  return map
}

/**
 * Domain label names (exported for convenience)
 */
export const DOMAIN_LABEL_NAMES: DomainLabel[] = Object.keys(DOMAIN_LABELS) as DomainLabel[]

/**
 * Type label names (exported for convenience)
 */
export const TYPE_LABEL_NAMES: TypeLabel[] = Object.keys(TYPE_LABELS) as TypeLabel[]

/**
 * Scope label names (exported for convenience)
 */
export const SCOPE_LABEL_NAMES: ScopeLabel[] = Object.keys(SCOPE_LABELS) as ScopeLabel[]
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