skills.rest
roseDwayane
roseDwayaneCOMMUNITY
Explore all skills by this author →
GitHub

add-linear

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

1|Updated May 22, 2026
Search Tags:#oauth#agent#issue tracking#linear#webhook#channel integration#chat sdk
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-linear-rosedwayane
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-linear
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-linear
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-linear-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @chat-adapter/linear.

What problem does it solve? NanoClaw does not ship channel adapters in trunk, so connecting an agent to Linear issue comment threads requires manually copying the adapter, registering it, installing the package, and configuring OAuth credentials and webhooks. This Skill automates that entire wiring process. ## 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, webhook configuration with signing secret, and environment variable setup synced to the agent container. - Channel Wiring: Inserts messaging group and agent wiring records with per-thread session mode so each issue comment thread gets its own isolated agent session. - Use Case: A team wants their NanoClaw agent to automatically respond to every comment on issues in their ENG Linear team without requiring @-mentions. ## Quick Start Ask the agent to add the Linear channel integration to your NanoClaw project and follow the prompts to provide your Linear OAuth credentials and team key.

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 channel 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 via /manage-channels or SQL inserts.

How to set up Linear OAuth for a bot that posts comments?▼

Create a Linear OAuth application under Settings > API > OAuth Applications, enable Client credentials grant type, and copy the Client ID and Secret. This lets the agent post as an app identity instead of as your personal account.

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

No, every comment on a Linear issue triggers the agent automatically. Linear OAuth apps cannot be @-mentioned, so the channel uses an engage mode that responds to plain comments rather than mention-only.

Why is my Linear webhook not delivering events?▼

Linear webhook delivery may be delayed 1-5 minutes for newly created webhooks, which is normal behavior. Verify the webhook URL points to your shared webhook server on port 3000 and that the Comment event is checked.

What is the difference between OAuth app and Personal API Key for Linear?▼

An OAuth app posts as a separate app identity and avoids self-message filtering issues. A Personal API Key is simpler but the agent posts as you, and your own comments get filtered as self-messages.

Related Skills

Explore More Software Engineering Skills→
wrightchinwrightchin

add-matrix

Integrate a Matrix chat adapter into NanoClaw from the channels branch.

Community
Intermediate
RADHA0-maxRADHA0-max
2

add-linear

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

Community
Intermediate
qwibitaiqwibitai
30.5k

add-telegram

Add Telegram as a channel to NanoClaw for agent messaging.

Official
Advanced
Rocktown-LabsRocktown-Labs
1

convex-quickstart

Scaffolds a barebones Next.js and Convex template from a one-sentence idea.

Official
Intermediate