ai-skill-garmin

Garmin Connect에 연결되어 시계 데이터를 자연어로 조회할 수 있는 에이전트 스킬입니다. Claude, Cursor, Gemini CLI, OpenCode, Goose 등 스킬 호환 에이전트에서 작동합니다.

다음과 같은 질문을 할 수 있습니다:

• "어젯밤에 잠을 어떻게 잤어?"
• "이번 주에 체육관 세션 몇 번 했어?"
• "내 안정 심박수 추세가 어떻게 돼?"
• "어제 걸음 목표를 달성했어?"
• "최근 5번 달리기 기록과 페이스를 보여줘."

에이전트가 데이터를 가져와서 답변합니다. 수동 대시보드나 Garmin Connect에서 클릭할 필요가 없습니다.

존재 이유

Garmin은 안정적인 공개 API가 없으며, 커뮤니티 라이브러리(garth, python-garminconnect)는 Garmin이 엔드포인트, 소비자 시크릿, 인증 흐름을 변경할 때마다 몇 달마다 깨집니다. 이 스킬은 2026년 3월 모바일 JSON 로그인 플로우를 자체적으로 포팅한 것으로, 얇은 CLI가 위에 붙어있습니다 — npm 종속성 0, 단일 TypeScript 파일, Bun으로 실행 가능.

요구 사항

• Bun (유일한 런타임)
• Garmin Connect 계정
• 이메일 기반 MFA 지원; SMS/앱 MFA는 소규모 확장이 필요할 수 있음

설치

skills CLI를 통한 설치 (vercel-labs/skills)

미리보기: npx skills add dsebastien/ai-skill-garmin --list

수동 설치

스킬은 SKILL.md에서 자동으로 검색됩니다. 에이전트 없이 CLI를 직접 실행할 수도 있습니다.

스킬 검증

설정

원하면 ~/.config/garmin-api/env에 유지하고 셸 rc에서 소스할 수 있습니다.

첫 로그인

MFA 없는 계정: login 한 번으로 완료됩니다.

토큰은 ~/.config/garmin에 캐시됩니다.

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.