클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Linear 채널 연동 추가 (NanoClaw)

NanoClaw 에이전트를 Linear 이슈 코멘트 스레드에 연결하는 설치·설정 레시피 스킬.

자동화·워크플로고급★ 30,573⑂ 12,843AI 점수 7/10마지막 업데이트: 2026. 8. 20.

무엇을 해주나

  • NanoClaw 저장소의 channels 브랜치에서 Linear 어댑터(src/channels/linear.ts)와 등록 테스트를 가져와 src/channels/에 복사합니다.
  • 채널 배럴(src/channels/index.ts)에 self-registration import를 한 줄 추가하고, @chat-adapter/linear를 정확한 버전으로 고정 설치합니다.
  • pnpm run build와 등록 테스트를 실행해 연동이 실제로 살아있는지 검증합니다.
  • Linear OAuth 앱(권장) 또는 Personal API Key, 웹훅 서명 시크릿, 팀 키 등을 프롬프트로 받아 .env에 기록합니다(이미 값이 있으면 덮어쓰지 않음).
  • ncl messaging-groups create / ncl wirings create로 특정 팀을 에이전트에 연결하고, 이슈별 스레드를 독립 세션(per-thread)으로 운용합니다.
  • 각 단계는 nc: 지시문 펜스로 감싸져 있어 파서가 결정적으로 재실행할 수 있고(멱등), 웹훅 지연·OAuth 401·발신자 정책 오류 등 트러블슈팅 가이드도 포함합니다.

이런 분께 추천

  • NanoClaw를 셀프호스팅하며 Linear를 팀 이슈 트래커로 쓰는 개발자/운영자.
  • Linear 이슈 코멘트에 @멘션 없이도 자동 응답하는 에이전트를 붙이고 싶은 팀.
  • pnpm·vitest·Unix 소켓 기반 서비스 운영에 익숙한 중급 이상 사용자.

활용 예시

  1. /setup 중간에 이 스킬을 실행해 Linear 채널을 추가하고, 완료 후 setup 플로우로 복귀.
  2. 사내 비공개 워크스페이스에서 public 발신자 정책으로 ENG 팀 전체 이슈 코멘트에 응답하는 봇 구성.
  3. 이미 연동했는데 응답이 없을 때, 등록 테스트(vitest run src/channels/linear-registration.test.ts)로 배럴 import·의존성 드리프트를 진단.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-linear/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-linear 폴더를 내 ~/.claude/skills/add-linear/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

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

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 폴더를 Claude 스킬 경로로 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/
  3. NanoClaw 프로젝트 루트에서 의존성을 설치하고(pnpm install) 호스트 서비스가 실행 중인지 확인합니다.
  4. Linear에서 OAuth 애플리케이션을 만들고 생성 후 Client credentials 그랜트를 켠 뒤 Client ID/Secret을 복사합니다(또는 Personal API Key 준비).
  5. Linear Settings > API > Webhooks에서 https://도메인/webhook/linear 주소, 대상 팀, Comment 이벤트로 웹훅을 만들고 서명 시크릿을 복사합니다.
  6. Claude Code를 NanoClaw 프로젝트 폴더에서 실행하고 "Linear 채널을 추가해줘"처럼 요청해 스킬을 발동시킵니다.
  7. 프롬프트에 Client ID/Secret, 웹훅 시크릿, 팀 키(예: ENG), 봇 표시명, 담당 에이전트 폴더(ncl groups list), 발신자 정책(public/strict)을 입력합니다.
  8. 마지막에 안내된 명령으로 서비스를 재시작하고, Linear 이슈에 코멘트를 남겨 응답을 확인합니다(신규 웹훅은 1~5분 지연될 수 있음).
GitHub에서 원본 보기 ↗라이선스: MIT