add-linear

Bridge Linear issue comment threads to NanoCrew agents via webhooks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CjLogic/nanocrew --skill add-linear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-linear
Source: https://github.com/CjLogic/nanocrew/tree/main/.codex/skills/add-linear
Command: npx skills add https://github.com/CjLogic/nanocrew --skill add-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridges Linear issue comment threads to the NanoCrew agent, enabling automatic responses and coordinated workflows without manual intervention.

Core Features & Use Cases

  • Channel integration: Connect Linear with NanoCrew to participate in issue discussions via automated messages.
  • Webhook-driven flow: Listen to Linear comment events and forward them to the agent for context-aware replies.
  • Security-conscious setup: Supports both OAuth app authentication and personal API keys, with webhook signature verification and per-thread sessions.
  • Use Case: A software team tracks issues in Linear; each new comment triggers an agent interaction that suggests fixes or automatically assigns tasks.

Quick Start

Follow the prerequisites, configure webhook credentials, and wire the Linear channel to an agent group to activate automated responses.

Frequently Asked Questions about add-linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate responses to Linear issue comments using an agent?

You can automate Linear issue comment responses by bridging comment threads to the NanoCrew agent via webhook integration, forwarding events for context-aware replies. This requires configuring webhook credentials and wiring the Linear channel to an agent group.

How does webhook signature verification work for Linear comment events?

Webhook signature verification for Linear comment events uses a signing secret to validate incoming payloads, ensuring forwarded thread context originates from Linear. This security-conscious setup supports both OAuth app authentication and personal API keys.

Can I use OAuth app authentication instead of personal API keys for Linear integration?

Yes, the Linear channel integration supports both OAuth app authentication and personal API keys for secure connectivity. You must configure the respective environment variables during setup to establish the authenticated webhook flow.

How do I set up a Chat SDK bridge for Linear issue threads?

Setting up the Chat SDK bridge for Linear issue threads involves an idempotent install path that patches the bridge, configuring environment variables, and wiring the webhook endpoint to your agent group to activate automated responses.

What's the best way to maintain thread continuity when forwarding Linear comments to an agent?

Maintaining thread continuity when forwarding Linear comments relies on per-thread sessions managed by the NanoCrew agent bridge. Each issue comment triggers a conversation, allowing the agent to respond or forward context while preserving the discussion state.

Why are my Linear webhook automated responses not triggering for new comments?

Linear webhook automated responses may fail if the signing secret is misconfigured, environment variables for OAuth or API keys are missing, or the Chat SDK bridge patch was not applied correctly through the idempotent install path.