skills.rest
Observatoriodomos
ObservatoriodomosCOMMUNITY
Explore all skills by this author →
GitHub

Setup tips & tricks — Linear × CMA webhook bridge

Convert Linear AgentSession events into Claude Managed Agents replies.

Updated May 7, 2026
Search Tags:#oauth#claude#linear#diff review#managed agents#webhook bridge#session routing
One-click install
npx skills add https://github.com/Observatoriodomos/DomosMirador --skill setup-tips-tricks-linear-cma-webhook-bridge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Setup tips & tricks — Linear × CMA webhook bridge
Source: https://github.com/Observatoriodomos/DomosMirador/tree/main/claude-cookbooks/managed_agents/linear
Command: npx skills add https://github.com/Observatoriodomos/DomosMirador --skill setup-tips-tricks-linear-cma-webhook-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides setup and debugging for a bridge that turns a user’s Linear @mention into a Claude Managed Agent (CMA) run, then posts the resulting CMA reply back into Linear as a comment.

Core Features & Use Cases

  • Webhook bridge mental model: Explains the “doorbell” nature of webhooks and why the bridge must translate IDs and routing metadata across Linear and CMA.
  • Routing via session metadata: Uses CMA session metadata (linear session id and org id) so the idle webhook can reliably find where to post the response in Linear.
  • Production-grade gotchas: Covers workspace scoping, required webhook event types, actor=app OAuth behavior, the 10-second ack requirement, and idempotency with event.id, plus debugging steps for silent failures.

Quick Start

Ask your agent to “walk me through setting this up” so it can follow the Linear OAuth app creation, Anthropic agent/webhook configuration, required environment variables, and then run the local bridge server to enable @mentions.

Frequently Asked Questions about Setup tips & tricks — Linear × CMA webhook bridge

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

FAQPage Schema
How do I set up a webhook bridge to post Claude Managed Agent replies to Linear comments?▼

To set up a webhook bridge, configure a Linear OAuth app with actor=app tokens, create an Anthropic Managed Agent, wire the webhook endpoint, and run a local bridge server to translate Linear AgentSession events into Claude Managed Agent replies posted back as Linear comments.

Why does my Linear webhook bridge fail silently after triggering a Claude agent run?▼

Silent failures often occur when the bridge misses the 10-second agentActivity acknowledgment requirement, lacks proper webhook signature verification, or fails idempotency checks using event-id, causing dropped responses during session event handling.

How does routing via CMA session metadata work for Linear webhook integrations?▼

Routing via CMA session metadata works by storing the linear session id and org id in the Claude Managed Agent session, allowing the idle webhook to reliably find the correct Linear issue and post the generated response as a comment.

Do I need workspace-aligned signing keys to verify Linear webhook events for Claude agents?▼

Yes, you need workspace-aligned signing keys to perform webhook signature verification, ensuring that incoming Linear AgentSession events are authentic before the bridge processes them and routes the data to Claude Managed Agents.

What are the prerequisites for integrating Linear @mentions with Claude Managed Agents?▼

Prerequisites include creating a Linear OAuth app, configuring an Anthropic Managed Agent, setting required environment variables, and implementing a stateless webhook bridge with retrieval-then-filter logic using session metadata.

Can I use a stateless webhook bridge to handle Linear OAuth app events for diff review?▼

Yes, a stateless webhook bridge can convert Linear AgentSession events into Claude Managed Agents replies for diff review, applying event-id idempotency and a 10-second acknowledgment to maintain reliable session routing.

Related Skills

Explore More Software Engineering Skills→
schpetschpet
897

linear-cli

Manage Linear issues via a command-line interface and GraphQL API.

Community
Advanced
ObservatoriodomosObservatoriodomos

setup tips & tricks — Slack × CMA webhook bridge

Bridge Slack @mentions to Claude Managed Agents and post results back to threads.

Community
Advanced
thevibeworksthevibeworks
28

Setup tips & tricks — Slack × CMA webhook bridge

Bridge Slack @mentions to Claude Managed Agent sessions and reply in-thread.

Official
Advanced
thevibeworksthevibeworks
28

Linear × Claude Managed Agents bridge

Translate Linear session events into Claude Managed Agents sessions and route responses back as comments.

Official
Advanced