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.ts

View on GitHub
/**
 * Label Taxonomy Type Definitions
 *
 * TypeScript interfaces for the domain-based label taxonomy system.
 * These types ensure consistent label definitions across the codebase.
 */

/**
 * Label categories (groups in Linear)
 */
export type LabelCategory = 'domain' | 'type' | 'scope'

/**
 * Domain labels for agent self-selection
 */
export type DomainLabel =
  | 'security'
  | 'performance'
  | 'infrastructure'
  | 'testing'
  | 'reliability'
  | 'core'
  | 'frontend'
  | 'backend'
  | 'integration'
  | 'documentation'
  | 'mcp'
  | 'cli'
  | 'neural'

/**
 * Type labels for work classification (exactly one required per issue)
 */
export type TypeLabel = 'feature' | 'bug' | 'refactor' | 'chore' | 'spike'

/**
 * Scope labels for impact flags (0-2 per issue)
 */
export type ScopeLabel =
  | 'breaking-change'
  | 'tech-debt'
  | 'blocked'
  | 'needs-split'
  | 'good-first-issue'
  | 'enterprise'
  | 'soc2'

/**
 * All taxonomy label names
 */
export type TaxonomyLabel = DomainLabel | TypeLabel | ScopeLabel

/**
 * Agent identifiers for routing
 */
export type AgentId =
  // Security agents
  | 'security-manager'
  | 'byzantine-coordinator'
  // Performance agents
  | 'performance-benchmarker'
  | 'perf-analyzer'
  // Infrastructure agents
  | 'swarm-init'
  | 'mesh-coordinator'
  // Testing agents
  | 'tester'
  | 'tdd-london-swarm'
  // Reliability agents
  | 'raft-manager'
  | 'gossip-coordinator'
  // Development agents
  | 'coder'
  | 'sparc-coder'
  | 'frontend-dev'
  | 'ui-designer'
  | 'backend-dev'
  | 'api-designer'
  | 'integration-specialist'
  | 'mcp-developer'
  | 'tool-builder'
  | 'cli-developer'
  // AI/ML agents
  | 'safla-neural'
  | 'collective-intelligence'
  // Documentation agents
  | 'researcher'
  // Review agents
  | 'reviewer'
  | 'planner'

/**
 * Definition of a single label in the taxonomy
 */
export interface LabelDefinition {
  /** Label name (lowercase, hyphenated) */
  name: TaxonomyLabel
  /** Category this label belongs to */
  category: LabelCategory
  /** Human-readable description for Linear AI triage */
  description: string
  /** Hex color code (with #) */
  color: string
  /** Primary agents that should handle this label (first choice) */
  primaryAgents?: AgentId[]
  /** Secondary agents as fallback */
  secondaryAgents?: AgentId[]
}

/**
 * Complete taxonomy structure
 */
export interface LabelTaxonomy {
  /** Domain labels for technical area routing */
  domain: Record<DomainLabel, LabelDefinition>
  /** Type labels for work classification */
  type: Record<TypeLabel, LabelDefinition>
  /** Scope labels for impact flags */
  scope: Record<ScopeLabel, LabelDefinition>
}

/**
 * Validation result for a set of labels
 */
export interface ValidationResult {
  /** Whether the label set is valid */
  valid: boolean
  /** Error messages if invalid */
  errors: string[]
  /** Warning messages (valid but suboptimal) */
  warnings: string[]
  /** Parsed labels by category */
  parsed: {
    domain: DomainLabel[]
    type: TypeLabel[]
    scope: ScopeLabel[]
    unknown: string[]
  }
}

/**
 * Label suggestion result
 */
export interface LabelSuggestion {
  /** Suggested label */
  label: TaxonomyLabel
  /** Category of the label */
  category: LabelCategory
  /** Confidence score (0-1) */
  confidence: number
  /** Reason for the suggestion */
  reason: string
}

/**
 * Agent selection result
 */
export interface AgentSelection {
  /** Primary agents recommended for this work */
  primary: AgentId[]
  /** Secondary/fallback agents */
  secondary: AgentId[]
  /** All labels considered in selection */
  labels: TaxonomyLabel[]
  /** Reasoning for selection */
  reasoning: string
}
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