Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Add Linear Channel (NanoClaw)

An idempotent install recipe that wires a NanoClaw agent into Linear issue comment threads.

AutomationAdvanced★ 30,573⑂ 12,843AI score 7/10Last updated: Aug 20, 2026

What it does

  • Copies the Linear adapter (src/channels/linear.ts) and its registration test from the repo's channels branch into src/channels/.
  • Appends the single self-registration import to src/channels/index.ts and installs @chat-adapter/linear at an exact pinned version.
  • Runs pnpm run build plus the registration test to prove the adapter is really in the registry and the dependency resolves.
  • Prompts for credentials — OAuth Client ID/Secret (recommended) or a Personal API key, webhook signing secret, team key, bot display name — and writes them to .env set-if-absent.
  • Wires one Linear team to an agent via ncl messaging-groups create / ncl wirings create, using pattern . engage mode (every comment triggers the agent) and per-thread sessions.
  • Every step lives in an nc: directive fence, so both an agent and a parser can apply it deterministically and re-run it safely; a detailed troubleshooting section covers webhook lag, OAuth 401s, self-message filtering, and policy typos.

Who it's for

  • Teams self-hosting NanoClaw that use Linear as their issue tracker.
  • Anyone who wants an agent answering every issue comment without @-mentions (Linear OAuth apps can't be mentioned).
  • Intermediate-to-advanced operators comfortable with pnpm, vitest, and launchd/systemd services.

Examples

  1. Mid-/setup: invoke the skill to add Linear, then return to the setup flow.
  2. Private workspace: choose public sender policy and route all ENG team issues to one agent group.
  3. Silent bot: run pnpm exec vitest run src/channels/linear-registration.test.ts to catch a dropped barrel import or missing dependency.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-linear/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/add-linear folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-linear/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Clone the repository: git clone https://github.com/nanocoai/nanoclaw.git
  2. Copy the skill into your Claude skills folder: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/
  3. From the NanoClaw project root, run pnpm install and make sure the host service is running (ncl talks to it over a Unix socket).
  4. In Linear, create an OAuth Application, then open it and enable the Client credentials grant; copy the Client ID and Secret (or prepare a Personal API key instead).
  5. Create a webhook under Linear Settings > API > Webhooks pointing at https://your-domain/webhook/linear, select the team, check the Comment event, and copy the signing secret.
  6. Open Claude Code inside the NanoClaw project and ask it to "add the Linear channel".
  7. Answer the prompts: OAuth credentials, webhook secret, team key (e.g. ENG), bot display name, agent folder (ncl groups list), and sender policy (public or strict).
  8. Restart the service with the command in Next Steps, then comment on a Linear issue to verify delivery — new webhooks can lag 1–5 minutes.
View source on GitHub ↗License: MIT