Skip to content
cccskills
FreePublished on GitHub

linear-expert

Linear expert for workspace/team admin, Cycles, Projects, Initiatives, Roadmaps, GraphQL API queries, triage workflows, GitHub integration, bulk operations, and Jira-to-Linear migration.

The English summary is being prepared. Showing the original description.

See how to install

Files included (8)

  • SKILL.md7.5 KB
  • assets/linear-team-template.md4.1 KB
  • assets/linear-triage-workflow.md5.2 KB
  • examples/jira-to-linear-migration.md11.7 KB
  • references/linear-concepts-and-workflows.md10.4 KB
  • references/linear-graphql-patterns.md12.9 KB
  • references/linear-vs-jira.md8.3 KB
  • references/red-flags.md13.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Linear Expert

Master-level expertise in Linear configuration, workflow design, GraphQL API mastery, Cycle and Project management, Initiative-level roadmaps, triage automation, GitHub integration, and migration from Jira. Covers everything from workspace setup to programmatic bulk operations against the Linear API.

Overview

Linear is an opinionated, keyboard-driven issue tracker built around a strict data model (Team → Project → Issue → Sub-issue) and a GraphQL-only public API. Unlike Jira, Linear's strength is its lack of configurability: there is one workflow shape (Backlog → Unstarted → Started → Completed → Canceled), one priority scale (0-4), and a tight set of first-class concepts (Cycles, Projects, Initiatives, Labels, Milestones). The job of a Linear expert is to operate fluently inside those rails while extending the system through the API, automations, and integrations.

Core Capabilities

  • Workspace & team configuration — URL keys, SSO, team keys, cycle cadence, estimation scales, workflow states, label taxonomy
  • Planning hierarchy — Cycles (sprints), Projects + Milestones, Initiatives, and Roadmap views
  • Triage automation — inbound routing from Slack, support, GitHub Issues; daily triage SOP
  • GraphQL API mastery — query/mutation authoring, pagination, batch mutations, webhooks, rate-limit hygiene
  • GitHub integration — magic-word auto-link/auto-close, branch auto-linking, PR-state syncing
  • Bulk operations & migration — API-driven bulk edits and Jira → Linear migration planning

When to Use

  • Setting up a new Linear workspace, team, or project from scratch
  • Designing Cycle cadence, triage rules, and SLA workflows
  • Writing GraphQL queries and mutations against the Linear API
  • Configuring GitHub PR auto-link/auto-close and Slack notifications
  • Building Initiative / Project / Milestone hierarchies for executive roadmaps
  • Running bulk operations (relabel, retarget, reassign) across hundreds of issues
  • Migrating an existing Jira instance to Linear without losing history
  • Diagnosing why automations, sub-issues, or triage rules are not firing as expected

Quick Start

Linear's API is GraphQL-only at https://api.linear.app/graphql; auth via personal API key (Authorization: <key>) or OAuth2.

linear_query() {
  curl -s -X POST https://api.linear.app/graphql \
    -H "Authorization: $LINEAR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$1\"}"
}

Cache team/label/state UUIDs locally, use nested selection to avoid N+1 calls, and prefer webhooks over polling. See the references below for the full query catalog and operating workflows.

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

Scope & Limitations

In Scope: Linear workspace, team, and project configuration; cycle and project planning; Initiative and Roadmap hierarchy; triage workflow design; GitHub PR integration; GraphQL query and mutation authoring; bulk operations via API; webhook configuration; Jira → Linear migration planning and execution.

Out of Scope: Jira-side configuration and migration freeze (hand off to jira-expert/); Notion documentation pages for Linear roadmaps (hand off to notion-pm/); strategic prioritization and OKR setting (hand off to senior-pm/, execution/brainstorm-okrs/); sprint coaching and team health (hand off to scrum-master/); release notes generation from Linear issues (hand off to execution/release-notes/).

Limitations: Linear has no custom fields; all extension happens through labels, descriptions, or external systems. As of September 2026 the Free plan caps at 250 issues and 2 teams; Initiatives are on every plan, but sub-initiatives and SAML/SCIM are Enterprise-only and team initiatives need Business or Enterprise (verify on linear.app/pricing). API rate limits depend on auth type, not plan: API keys get 2,500 requests/hour per user, OAuth apps 5,000/hour, each with an hourly complexity budget; heavy automation may require coordination. Importers preserve most history but cannot recreate Jira's custom workflow states; mapping is many-to-five. GraphQL schema evolves continuously; pin client code to the deprecation calendar.

Integration Points

IntegrationDirectionWhat Flows
jira-expert/Jira → LinearMigration mappings, custom-field translation, freeze coordination
notion-pm/Linear → NotionRoadmap embeds, Initiative pages, project status rollups
execution/create-prd/PRD → LinearPRD page becomes the Linear Project description; PRD sections become Milestones
execution/brainstorm-okrs/OKR → LinearInitiatives mapped to Objectives; Projects tagged with KR identifiers
execution/outcome-roadmap/Roadmap → LinearOutcome roadmap rows mapped to Linear Initiatives; outputs become Projects
execution/release-notes/Linear → Release NotesClosed issues in a cycle/project become release note line items
execution/prioritization-frameworks/Scoring → LinearRICE/WSJF scores written back to labels or description fields
scrum-master/Linear → AnalyticsCycle data feeds velocity_analyzer.py and sprint_health_scorer.py
senior-pm/Linear → PortfolioInitiative-level rollups feed project_health_dashboard.py
delivery-manager/Linear → ReleaseProject completion state and milestone dates feed release coordination

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

This skill should be used when the user asks to "check accessibility", "audit WCAG compliance", "scan HTML for a11y issues", "check color contrast", or "find accessibility violations in web pages".

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

Design and run statistically rigorous A/B tests and experiments. Use when planning experiments, calculating sample sizes, designing test variants, selecting metrics, analyzing results, or when someone says "let's test that."

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

Design and analyze A/B tests: sample size, test duration, and statistical significance for conversion experiments. Use when setting up an A/B test, calculating sample size, designing an experiment, or analyzing results.

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

Sales execution across pipeline, discovery, demos, negotiation, and closing. Use when qualifying opportunities, running MEDDIC discovery, building account plans, handling objections, structuring proposals, or forecasting pipeline.

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

Design ad creative across Google, Meta, LinkedIn, Twitter/X, and TikTok with platform format specs, headline formulas, and A/B testing. Use when writing ad copy, generating headline variations, creating ad sets, or validating creative.

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

aeo

Free

Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers. Use when designing content for LLM citation, auditing citability, or structuring Q&A schema.

The English summary is being prepared. Showing the original description.

borghei/Claude-Skills948Updated Oct 7, 2026

See all skills by borghei

Report a problem with this skill