흐민의 Claude Code 스킬 모음입니다. 누구나 설치해서 쓸 수 있어요.
| 스킬 | 하는 일 | 설치 |
|---|---|---|
| 📱 claudecode-channel:telegram | 휴대폰 텔레그램에서 내 PC의 Claude에게 일을 시키기 | claudecode-channel |
| 📅 google-connect:calendar | 구글 캘린더 연결 + 일정 읽기·쓰기 | google-connect |
휴대폰 텔레그램에서 내 PC의 Claude Code에게 일을 시킬 수 있도록, 봇 연동을 처음부터 끝까지 대화로 안내하는 스킬입니다. 비개발자·Windows 초보를 기준으로 만들었어요.
- 한 단계씩 설명하고, 매 단계 실제로 됐는지 Claude가 직접 확인해 줍니다.
- 매 단계
(N/7)진행 표시 + "받는 창 / 코치 창" 비유로 두 터미널 구조를 끝까지 헷갈리지 않게 안내합니다. - 중간에 세션을 다시 켜야 하는 구간이 있어도,
/claudecode-channel:telegram을 다시 실행하면 멈춘 지점부터 이어서 끝까지 진행합니다. - 토큰 비노출·접근 권한은 사용자가 직접 설정 등 보안 가드레일 내장.
/plugin marketplace add hminnnnnn/claude-code-skills
/plugin install claudecode-channel@claude-code-skills
/reload-plugins
그다음 /claudecode-channel:telegram 을 실행하면 안내가 시작됩니다.
Claude가 현재 상태를 점검한 뒤, 봇 생성(BotFather) → 플러그인 설치 → 토큰 등록 →
받는 창(--channels) 켜기 → 페어링 → 보안 잠금 → 최종 확인 순서로 안내합니다.
Windows에서 Claude Code가 아직 없다면? 먼저 windows-setup.md 의 "0단계: 사전 준비"를 따라 Claude Code와 Bun을 설치하세요.
빠른 명령 요약·트러블슈팅은 manual-guide.md 에 있습니다.
구글 로그인 한 번이면 캘린더가 붙습니다. 클라우드 프로젝트 만들기 · 캘린더 API 켜기 · 동의 화면 구성 · 앱 열쇠 발급 · 앱 게시 · 권한 승인 — 이 여섯 단계를 Claude가 크롬을 직접 조작해서 대신 처리합니다. 보통 3~5분 걸립니다.
연결한 뒤에는 이렇게 말하면 됩니다:
"내일 일정 뭐 있어?"
"금요일 3시에 B고객 미팅 넣어줘"
"그 미팅 4시로 옮겨줘"
- 막히면 이어서 합니다. 끝난 단계는 저장되므로 다시 실행하면 막힌 곳부터 갑니다. 처음부터 다시 하지 않습니다.
- 읽기 전용 캘린더를 정직하게 구분합니다. 공휴일이나 남이 공유해 준 캘린더는 구글이
막습니다(
accessRole=reader) — 우리 권한 문제가 아니고, 구글 캘린더 앱에서도 못 고칩니다. 스킬이 그렇게 말해 줍니다. - 자동 연결이 계속 막히면 손으로 하는 절차(manual-guide.md)로 안전하게 내려옵니다. ①~⑤를 손으로 한 뒤 남은 권한 승인만 자동으로 이어받습니다.
/plugin marketplace add hminnnnnn/claude-code-skills
/plugin install google-connect@claude-code-skills
/reload-plugins
그다음 "캘린더 연결해줘" 라고 말하면 시작됩니다.
- Node.js 18+ —
node -v로 확인. 없으면 nodejs.org 에서 LTS 설치. (⚠️ bun 으로는 안 됩니다 — 브라우저에 붙는 통신 계층이 bun 에서 깨집니다.) - 구글 크롬 — 스킬이 알아서 찾습니다(맥·윈도우·리눅스). 사파리·엣지로는 안 됩니다.
- 첫 연결 때
playwright-core하나를 받습니다(약 1초). 브라우저는 새로 내려받지 않습니다 — 이미 쓰고 있는 크롬을 그대로 씁니다.
연결이 끝나면 일정을 다루는 건 의존성 없는 Node 스크립트 하나입니다. 셸을 쓸 수 있는 에이전트라면 무엇이든 그대로 부를 수 있습니다.
cd plugins/google-connect/skills/calendar/scripts
node calendar.mjs calendars # 캘린더 목록 (쓰기 가능 여부까지)
node calendar.mjs list --days 7 # 앞으로 7일
node calendar.mjs list --from 2026-08-01 --to 2026-08-31 --all # 기간 · 모든 캘린더
node calendar.mjs add --title "미팅" --start "내일 15:00" --duration 60
node calendar.mjs update <일정id> --start "내일 16:00" # 길이는 유지됩니다
node calendar.mjs delete <일정id>
node calendar.mjs verify # 연결 확인--json 을 붙이면 기계가 읽을 모양으로 나옵니다. 시각은 2026-08-05T15:00 ·
"내일 15:00" · "오후 3시" · "+2d 14:00" 같은 모양을 받고, 못 읽으면 지어내지 않고
거부합니다.
~/.google-calendar/credentials.json (권한 600). 홈 폴더에 두므로 한 번 연결하면 어느
폴더에서 어떤 도구를 켜든 같은 열쇠를 씁니다.
- 권한 범위는 캘린더뿐입니다 — 일정 읽기·쓰기 + 캘린더 목록 읽기. 메일·연락처·파일은 요청하지 않습니다. 캘린더 자체를 만들거나 지우는 권한도 받지 않습니다.
- 열쇠는 이 컴퓨터에만 있고 어디로도 전송되지 않습니다. 이 파일은 비밀번호와 같습니다 — 공유하거나 저장소에 커밋하지 마세요.
- 끊고 싶으면 구글 계정 → 보안 → '타사 앱' 에서 해제하고 열쇠 파일을 지우면 됩니다.
바꿀 수 있는 것: GCAL_HOME · GCAL_KEYFILE · GCAL_APP_NAME · GCAL_TZ · CHROME_PATH.
자세한 건 SKILL.md 4번 항목에 있습니다.
참석자 초대·알림 설정은 다루지 않습니다. 캘린더 자체를 만들거나 지우지 못합니다. 반복 일정은 개별 회차로 다루므로, 반복 규칙 전체를 바꾸는 건 구글 캘린더 앱에서 해야 합니다.
터미널을 따로 열 필요 없이, 실행 중인 Claude Code 세션 입력창에 차례로 입력하세요:
/plugin marketplace add hminnnnnn/claude-code-skills
/plugin install <플러그인이름>@claude-code-skills
/reload-plugins
<플러그인이름> 은 claudecode-channel 또는 google-connect 입니다. 둘 다 설치해도 됩니다.
⚠️ /reload-plugins까지 실행해야 스킬이 활성화됩니다. 설치만 하고 빼면/claudecode-channel:telegram이나 캘린더 스킬이 잡히지 않습니다.
git clone https://github.com/hminnnnnn/claude-code-skills.git
# 텔레그램
cp -R claude-code-skills/plugins/claudecode-channel/skills/telegram ~/.claude/skills/telegram
# 구글 캘린더
cp -R claude-code-skills/plugins/google-connect/skills/calendar ~/.claude/skills/calendar- Windows:
%USERPROFILE%\.claude\skills\아래에 넣습니다. - macOS / Linux:
~/.claude/skills/아래에 넣습니다.
Claude Code를 다시 실행하면 /telegram · /calendar 로 쓸 수 있습니다.
(마켓플레이스로 설치하면 /claudecode-channel:telegram · /google-connect:calendar 형태로 불립니다.)