Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

linear-expert

/linear-expert

Administruje zespołami, cyklami, projektami i triażem w Linear oraz pisze wywołania GraphQL, w tym migracje z Jiry.

Repozytorium
Claude-Skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Administruje zespołami, cyklami, projektami i triażem w Linear oraz pisze wywołania GraphQL, w tym migracje z Jiry.

Oryginalny opis (EN)

Administers Linear teams, cycles, projects and triage, and writes GraphQL API calls. Use when setting up or fixing a Linear workspace, scripting bulk changes, or migrating from Jira to Linear.

Jak działa

  1. Overview
  2. Core Capabilities
  3. When to Use
  4. Clarify First
  5. Quick Start
  6. Anti-Patterns
  7. Reference Documentation
  8. Scope & Limitations
  9. Integration Points
  10. Files
Sekcje z nagłówków SKILL.md, w oryginale · 127 linii, 1 551 słów
Podgląd SKILL.md
---
name: linear-expert
description: >
  Administers Linear teams, cycles, projects and triage, and writes GraphQL
  API calls. Use when setting up or fixing a Linear workspace, scripting bulk
  changes, or migrating from Jira to Linear.
license: MIT + Commons Clause
metadata:
  version: 1.0.1
  author: borghei
  category: project-management
  domain: pm-integration
  updated: 2026-11-08
  tech-stack: [linear, graphql, github, slack]
  tags: [linear, graphql, cycles, initiatives, roadmaps, triage, migration]
---
# 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

## Clarify First

Linear advice depends most on the user's plan, whether the work reads data or changes it, and where the workspace is starting from. Settle the inputs below before producing anything. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

- **Plan:** The Free plan caps at 250 issues and 2 teams. Sub-initiatives and SAML/SCIM are Enterprise-only, and team initiatives need Business or Enterprise. A planning hierarchy or SSO setup that relies on these fails on a lower plan.
- **Read-only or writing through the API:** A GraphQL query changes nothing. Bulk mutations across hundreds of issues, webhook handlers and migration imports change shared data and are hard to undo, so they deserve a dry run on a small sample. API keys get 2,500 requests per hour per user and OAuth apps 5,000, which sets how a bulk job has to be batched.
- **Starting point:** A new workspace can follow `assets/linear-team-template.md`. An existing workspace needs its current teams, workflow states, labels and cycle cadence before you change them. A Jira migration needs a map from every Jira status to one of Linear's five workflow categories, and a decision on where each Jira custom field goes, since Linear has none.
- **Team count and size:** Cycle cadence, estimation scale, triage rotation and whether Initiatives are worth using all scale with the number of teams and people. A single team of five needs far less structure than ten teams reporting to an executive roadmap.

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

## Quick Start

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

```bash
# $1 = GraphQL document, $2 = variables as JSON (optional). jq builds the body, so quotes
# and newlines in the query are escaped correctly; pass values as variables, not by string splicing.
linear_query() {
  local vars="${2:-}"
  [ -z "$vars" ] && vars='{}'
  jq -n --arg q "$1" --argjson v "$vars" '{query: $q, variables: $v}' |
    curl -s -X POST https://api.linear.app/graphql \
      -H "Authorization: $LINEAR_API_KEY" \
      -H "Content-Type: application/json" \
      --data @-
}

linear_query 'query { viewer { id name } }'
linear_query 'query($id: String!) { issue(id: $id) { title state { name } } }' '{"id": "ENG-123"}'
```

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.

## Anti-Patterns

### Trusting unsigned webhooks
**Mistake:** A Linear webhook posts to an internal service that acts on the payload without checking where it came from.
**Why it happens:** The integration works in testing, and verification looks like optional hardening.
**Instead:** Validate the `Linear-Signature` header in every webhook handler before acting. Without it, anyone can forge or replay events that trigger deletions, status changes or notifications. Any handler that skips the check needs a security review now.

### Migrating from Jira without a status map
**Mistake:** Thousands of Jira issues are bulk-imported and every status lands in Backlog.
**Why it happens:** The importer runs without one, and mapping many Jira states onto Linear's five workflow categories takes work.
**Instead:** Write a table that maps each Jira status to a Linear state before you import (see `references/linear-vs-jira.md`). A migration plan with no status-mapping table is not ready to run.

### Letting Triage pile up
**Mistake:** The Triage queue holds hundreds of issues going back months.
**Why it happens:** Nobody owns Triage, so it only gets done when someone has spare time.
**Instead:** Staff Triage with a rotation and a daily routine (`assets/linear-triage-workflow.md`). If the queue passes 30 issues or the oldest is over 14 days old, add triage capacity.

Seven more, each with a bad and a good example: `references/red-flags.md`.

## Reference Documentation

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

- **[references/linear-concepts-and-workflows.md](references/linear-concepts-and-workflows.md)** — Linear data model, the 7 core workflows (setup, cycle/project planning, initiatives, triage, GitHub, bulk ops, Jira migration), best practices, and success criteria. Read when configuring a workspace or running any of the core operating workflows.
- **[references/linear-graphql-patterns.md](references/linear-graphql-patterns.md)** — canonical query and mutation catalog with variables, plus inline quick examples and CLI patterns. Read when authoring any GraphQL query/mutation or scripting against the API.
- **[references/linear-vs-jira.md](references/linear-vs-jira.md)** — concept-by-concept translation guide for teams migrating from Jira. Read before planning a Jira → Linear migration.
- **[references/red-flags.md](references/red-flags.md)** — common anti-patterns (cycle-as-sprint, project bloat, N+1, untriaged inbox, unsigned webhooks) plus the troubleshooting table. Read before applying config/queries to a team or when diagnosing failures.
- **[assets/linear-team-template.md](assets/linear-team-template.md)** — recommended new-team configuration. Read when standing up a new team.
- **[assets/linear-triage-workflow.md](assets/linear-triage-workflow.md)** — daily triage SOP and rotation template. Read when staffing or designing triage.
- Linear API docs: https://developers.linear.app/docs
- Linear GraphQL schema explorer: https://studio.apollographql.com/public/Linear-API/
- Linear method (workspace conventions): https://linear.app/method

## 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

| Integration | Direction | What Flows |
|---|---|---|
| `jira-expert/` | Jira → Linear | Migration mappings, custom-field translation, freeze coordination |
| `notion-pm/` | Linear → Notion | Roadmap embeds, Initiative pages, project status rollups |
| `execution/create-prd/` | PRD → Linear | PRD page becomes the Linear Project description; PRD sections become Milestones |
| `execution/brainstorm-okrs/` | OKR → Linear | Initiatives mapped to Objectives; Projects tagged with KR identifiers |
| `execution/outcome-roadmap/` | Roadmap → Linear | Outcome roadmap rows mapped to Linear Initiatives; outputs become Projects |
| `execution/release-notes/` | Linear → Release Notes | Closed issues in a cycle/project become release note line items |
| `execution/prioritization-frameworks/` | Scoring → Linear | RICE/WSJF scores written back to labels or description fields |
| `scrum-master/` | Linear → Analytics | Cycle data feeds velocity_analyzer.py and sprint_health_scorer.py |
| `senior-pm/` | Linear → Portfolio | Initiative-level rollups feed project_health_dashboard.py |
| `delivery-manager/` | Linear → Release | Project completion state and milestone dates feed release coordination |

## Files

Reference files are described under Reference Documentation above. Templates:

| File | Purpose |
|------|---------|
| `assets/linear-team-template.md` | Team setup template |
| `assets/linear-triage-workflow.md` | Triage workflow template |
Pliki w paczce (8)
  • SKILL.md 11 KB
  • assets/linear-team-template.md 4 KB
  • assets/linear-triage-workflow.md 5 KB
  • examples/jira-to-linear-migration.md 12 KB
  • references/linear-concepts-and-workflows.md 10 KB
  • references/linear-graphql-patterns.md 13 KB
  • references/linear-vs-jira.md 8 KB
  • references/red-flags.md 13 KB

Wersje

W bazie nie ma innych skilli o nazwie linear-expert.

Migawka bazy z 13.11.2026 · wersja paczki 5d735b19e7f6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100linear
    Zarządza zespołami, projektami, cyklami, zgłoszeniami, komentarzami, stanami workflow i dokumentami Linear z terminala przez publiczne API GraphQL.
  • 90Linear GraphQL Patterns
    Pomaga pisać i recenzować zapytania GraphQL do API Linear: fragmenty, typy połączeń, batching i unikanie przestarzałych pól.
  • 100linear
    Zarządza zgłoszeniami, projektami, cyklami i pracą zespołów w Linear: tworzy, aktualizuje, segreguje i wyszukuje tickety.
  • 100linear-api
    Czyta i zarządza zgłoszeniami, projektami, cyklami, zespołami, komentarzami i etykietami w Linear przez API, także po adresie linear.app lub identyfikatorze typu ENG-123.
  • 100linear
    Wspiera pracę z Linear: cykle, projekty, triage, przepływy z klawiatury i integracja przez GraphQL API w szybkim wytwarzaniu oprogramowania i śledzeniu błędów.
  • 90linear
    Zarządza zgłoszeniami, projektami i cyklami w Linear przez serwer MCP: triażuje, tworzy, aktualizuje, planuje sprint i równoważy obciążenie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.