Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Integracja z narzędziem

linear

/linear

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.

Repozytorium
Agent-Skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.10.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.10.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

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.

Oryginalny opis (EN)

Expert Linear issue tracking assistance covering cycles, projects, triage, keyboard-first workflows, and GraphQL API integration. Use when managing fast software development workflows and bug tracking.

Jak działa

  1. When to Use
  2. Quick Start
  3. Core Concepts
  4. Common Patterns
  5. Best Practices
  6. Troubleshooting
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 147 linii, 639 słów
Podgląd SKILL.md
---
name: linear
description: Expert Linear issue tracking assistance covering cycles, projects, triage, keyboard-first workflows, and GraphQL API integration. Use when managing fast software development workflows and bug tracking.
---

# Linear

Linear is a streamlined, keyboard-first issue tracking and project management platform designed for high-velocity software engineering teams.

## When to Use

- **High-Velocity Issue Tracking for Engineering Teams**: Fast, keyboard-first issue tracking and project management.
- **Cycles & Project Roadmapping**: Planning 2-week engineering cycles, tracking velocity, and milestones.
- **GitHub & GitLab PR Synchronization**: Automatically moving issues to _In Progress_ on branch creation and _Done_ on PR merge.
- **Linear GraphQL API Automation**: Automating issue creation, triage bots, and metrics collection via GraphQL.

## Quick Start

```bash
# Query Linear GraphQL API for assigned issues
curl -X POST https://api.linear.app/graphql \
  -H "Authorization: $LINEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ viewer { assignedIssues(filter: { state: { type: { eq: \"started\" } } }) { nodes { id identifier title } } } }"}'
```

## Core Concepts

### Linear GraphQL API Integration with Python

Querying and creating issues programmatically:

```python
import requests
import os

LINEAR_API_URL = "https://api.linear.app/graphql"
API_KEY = os.environ["LINEAR_API_KEY"]

headers = {
    "Authorization": API_KEY,
    "Content-Type": "application/json"
}

# GraphQL Mutation to create an engineering issue
create_issue_mutation = '''
mutation CreateIssue($teamId: String!, $title: String!, $description: String!) {
  issueCreate(input: {
    teamId: $teamId
    title: $title
    description: $description
    priority: 1 # Urgent
  }) {
    success
    issue {
      id
      identifier
      url
    }
  }
}
'''

variables = {
    "teamId": "TEAM_UUID_HERE",
    "title": "Investigate elevated latency on payment webhook worker",
    "description": "P99 latency spiked above 1200ms following deployment v2026.1.0."
}

res = requests.post(LINEAR_API_URL, json={"query": create_issue_mutation, "variables": variables}, headers=headers)
print("Created Issue:", res.json())
```

### Git Branch & PR Automation Rules

Linking code to Linear issues automatically:

```bash
# Branch naming convention: <username>/<issue-identifier>-<description>
git checkout -b alice/eng-402-checkout-rate-limit

# Commit message linking
git commit -m "fix(checkout): enforce rate limiting on token endpoint (Fixes ENG-402)"
```

Linear automatically moves `ENG-402` to:

- **In Progress** when the branch is pushed.
- **In Review** when a Pull Request is opened.
- **Done** when the Pull Request is merged into `main`.

### Essential Keyboard Shortcuts

Operating Linear with speed:

- `C`: Create new issue.
- `Cmd + K`: Open Command Menu.
- `S`: Change issue state (Todo, In Progress, Done).
- `P`: Change priority (Urgent, High, Medium, Low).
- `A`: Assign issue to team member.

## Common Patterns

### Automated Issue Creation via GraphQL API

**Problem**: Creating Linear tickets automatically from CI/CD alert hooks.  
**Solution**: Execute Linear GraphQL mutation via curl or script.

```bash
curl -X POST "https://api.linear.app/graphql" \
  -H "Authorization: $LINEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation IssueCreate($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id title url } } }",
    "variables": {
      "input": {
        "teamId": "TEAM_UUID",
        "title": "Bug: Production CPU Spike",
        "description": "CPU exceeded 90% on api-gateway-pod-3."
      }
    }
  }'
```

## Best Practices

**Do**:

- Name Git branches using the Linear issue identifier (`eng-102-fix-auth`) to enable automated status synchronization.
- Use Linear's Triage inbox to review and accept incoming bugs and feature requests before backlog addition.
- Set issue estimates (points or t-shirt sizes) to track team velocity across cycles.
- Use the Linear GraphQL API for automated triage bots and Slack integrations.

**Don't**:

- Leave completed issues un-merged or open; link pull requests so status updates automatically.
- Create massive multi-month tickets; break large epics into distinct sub-issues.
- Commit `LINEAR_API_KEY` to public repositories.

## Troubleshooting

| Error                                    | Cause                                                                         | Solution                                                              |
| :--------------------------------------- | :---------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| `GraphQL error: 401 Unauthorized`        | Invalid `LINEAR_API_KEY` or missing scopes.                                   | Generate API key in Linear Settings > API > Personal API Keys.        |
| `GitHub integration not updating issues` | Webhook disconnected or repository not linked in Linear integration settings. | Re-authenticate GitHub integration in Linear Settings > Integrations. |
| `Cycle burndown chart not updating`      | Issues added to cycle without estimate story points.                          | Assign points/estimates to issues in cycle backlog.                   |

## References

- [Linear Documentation](https://linear.app/docs)

Wersje

RepozytoriumWynikLicencja
Ta strona · G1Joshi/Agent-Skills100MIT
jjuraszek/pi-gauntlet100MIT
TerminalSkills/skills100Apache-2.0
OpenHands/extensions100MIT
magnus919/agent-skills100MIT
joe-broadhead/opencode-linear100MIT
glebis/claude-skills100MIT
apideck-libraries/api-skills100Apache-2.0
getsentry/junior100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 552d0aada22c (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

  • 98linear-issue-tracking-best-practices
    Pomaga ustawić Linear dla zespołu: cykle, projekty, statusy i zarządzanie zgłoszeniami przez API, w porównaniu z Jirą.
  • 100linear-core-workflow-b
    Obsługuje przepływy pracy z projektami i cyklami w Linear, przydatne przy planowaniu sprintów, roadmap i organizowaniu pracy w cykle.
  • 100linear-expert
    Administruje zespołami, cyklami, projektami i triażem w Linear oraz pisze wywołania GraphQL, w tym migracje z Jiry.
  • 90devartslab-linear
    Obsługuje Linear przez narzędzia MCP: przegląda, tworzy, aktualizuje i porządkuje zgłoszenia, projekty, cykle, dokumenty i wydania.
  • 100mcp-server-linear
    Instaluje serwer MCP Linear do śledzenia zadań, cykli sprintów i triażu projektów oraz obsługuje jego narzędzia.
  • 100use-linear-cli
    Obsługuje Linear przez linear-cli: zgłoszenia, operacje zbiorcze, wyszukiwanie oraz przepływy z gałęziami git i PR.

Uwagi i zgłoszenia

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