add-linear

Integrates Linear issue comment threads as agent conversations via the Chat SDK adapter.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-linear-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-linear
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-linear
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-linear-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @chat-adapter/linear.

What problem does it solve? NanoClaw does not ship channel integrations in trunk, so connecting an agent to Linear issue comment threads requires manually copying the adapter, registering it, installing the package, and wiring credentials and webhooks. This Skill automates that entire setup so the agent can respond to Linear issue comments automatically. ## Core Features & Use Cases - Adapter Installation: Copies the Linear adapter and its registration test from the channels branch, appends the self-registration import, and installs the pinned @chat-adapter/linear package. - Credential & Webhook Setup: Guides creation of a Linear OAuth app or personal API key, configures a comment webhook, and sets all required environment variables. - Channel Wiring: Creates the messaging group and wiring via ncl with per-thread session mode so each issue comment thread gets its own agent session. - Use Case: A team wants their NanoClaw agent to automatically respond to every comment on issues in the ENG Linear team, with each issue thread isolated as its own conversation. ## Quick Start Ask the agent to add the Linear channel integration to NanoClaw and walk you through OAuth app creation, webhook setup, and channel wiring.

Frequently Asked Questions about add-linear

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

FAQPage Schema
How do I add a Linear integration to NanoClaw?

Run this skill to copy the Linear adapter from the channels branch, register it in src/channels/index.ts, install @chat-adapter/linear, and configure credentials. Then wire the channel to an agent group using /manage-channels or ncl commands.

Should I use a Linear OAuth app or a personal API key for a bot?

A Linear OAuth app is recommended because the agent posts under an app identity rather than as you, avoiding self-message filtering of your own comments. A personal API key is simpler but the agent posts as you and your comments get filtered.

Does the Linear integration require @-mentions to trigger the agent?

No, every comment on a Linear issue triggers the agent automatically via webhook events. Linear OAuth apps cannot be @-mentioned, so choose an engage mode that responds to plain comments when wiring the channel.

Why is my Linear webhook not delivering events after setup?

Linear webhook delivery may be delayed one to five minutes for newly created webhooks, which is normal behavior. Verify the webhook URL points to your shared webhook server, the Comment event is checked, and the signing secret matches LINEAR_WEBHOOK_SECRET.

How are Linear issue threads mapped to agent sessions?

Each issue comment thread becomes its own conversation using per-thread session mode. The platform ID is linear:<TEAM_KEY>, and all issues in the configured team route to one messaging group with isolated sessions per thread.