Skills

Skills란?

Skill은 AI 에이전트가 시세 조회, 주문 같은 작업을 정해진 순서대로 처리하도록 돕는 가이드입니다.

Bithumb Skills를 Claude Code, Cursor, Codex, Amp, Cline, Windsurf 등 Skills를 지원하는 AI 에이전트에 등록하면 자연어 요청을 이해하고 필요한 조회, 확인, 주문 작업을 순서대로 실행합니다.

설치

Skill은 AI 에이전트로 설치하거나 직접 설치할 수 있습니다. Claude Code, Codex 같은 에이전트를 이미 쓰고 있다면 아래 AI 에이전트로 설치가 가장 빠릅니다.

AI 에이전트로 설치

Claude Code, Codex 같은 에이전트를 쓰고 있다면 CLI와 Skill을 한 번에 자동 설치할 수 있습니다. 절차는 CLI 페이지의 AI 에이전트로 설치를 참고하세요. 설치가 끝나면 아래 정상 동작 확인으로 이동하면 됩니다.

에이전트 설치에 실패했거나 Skill만 추가하고 싶다면 아래 수동 설치와 인증 설정을 따르세요.

수동 설치

Node.js 18 이상과 빗썸 CLI가 필요합니다. CLI가 없다면 CLI 페이지의 수동 설치를 먼저 따르세요.

모든 스킬을 한 번에 설치하려면 --all 옵션을 사용합니다.

npx skills@latest add bithumb-official/bithumb-ai-trade-kit --all

스킬이나 설치 방식을 직접 선택하고 싶다면 옵션 없이 실행합니다.

npx skills@latest add bithumb-official/bithumb-ai-trade-kit

실행하면 다음 순서로 진행됩니다.

1. 설치할 스킬을 선택합니다. 기본 화면은 각 스킬을 개별 토글로 선택하는 방식이며, 키보드 a를 누르면 전체를 한 번에 선택할 수 있습니다.
2. 설치 대상 에이전트를 확인합니다(Amp, Antigravity, Cline, Codex, Cursor, Claude Code 등 자동 탐지).
3. 설치 범위를 선택합니다(Project 또는 User 전역).
4. 설치 방식을 선택합니다. Symlink(권장)는 스킬 파일을 원본 위치에 두고 에이전트 설정 폴더에 링크만 만들어, npx skills upgrade로 스킬을 업데이트할 때 재설치 없이 바로 반영됩니다. Copy는 파일을 에이전트 설정 폴더에 직접 복사합니다. 이 경우 업데이트 시 재설치가 필요합니다.

설치가 끝나면 에이전트의 도구 목록에 다음 스킬이 추가됩니다.

Market 스킬만 사용한다면 바로 정상 동작 확인으로 이동해도 됩니다. 잔고, 주문, 입출금 스킬을 사용하려면 인증 설정에서 API Key를 등록하세요.

인증 설정

CLI와 동일하게 환경 변수로 설정합니다. 영구 설정은 ~/.zshrc 또는 ~/.bashrc에 추가하세요.

export BITHUMB_ACCESS_KEY="발급받은_액세스_키"
export BITHUMB_SECRET_KEY="발급받은_시크릿_키"

Windows 환경 등 세부 설정은 CLI 페이지의 인증 설정을 참고하세요. 스킬은 같은 환경 변수와 TOML 설정을 공유합니다.

정상 동작 확인

에이전트를 재시작한 뒤 아래 순서대로 확인해 보세요.

스킬 감지 확인

터미널에서 설치된 스킬 목록을 확인합니다.

npx skills list

bithumb-market(시세 조회), bithumb-account(잔고 조회), bithumb-trade(주문), bithumb-deposit(입금), bithumb-withdraw(출금), bithumb-system(진단·실행 로그)이 목록에 있으면 정상 설치된 상태입니다.

인증 없이 동작 확인

에이전트에 자연어로 요청합니다.

• "KRW-BTC 현재가 알려줘"
• "빗썸 마켓 목록 보여줘"

bithumb-market 스킬이 활성화되어 bithumb market ticker KRW-BTC 명령을 실행하고 결과를 반환하면 정상입니다.

인증 동작 확인

API Key가 설정되어 있다면 인증이 필요한 기능도 확인합니다.

• "내 잔고 확인해줘"

bithumb-account 스킬이 bithumb account assets를 실행해 잔고를 반환하면 정상입니다. 인증 오류가 발생하면 아래 문제 해결을 참고하세요.

사용 예시

스킬의 가장 큰 장점은 여러 단계가 필요한 작업을 자연어 한 줄로 맡길 수 있다는 것입니다. 에이전트가 스킬에 정의된 절차대로 단계를 순서대로 실행합니다.

MCP가 도구 하나를 직접 실행하는 방식이라면, Skills는 확인, 주문, 검증 같은 여러 단계를 한 흐름으로 처리합니다.

보안 권장사항

• SKILL.MD 파일에는 API Key를 직접 적지 마세요. Key는 환경 변수나 ~/.bithumb/config.toml에서 읽어옵니다.
• 출금이나 원화 입금처럼 실제 자금이 움직이는 작업이 포함된 스킬에는 사용자 확인 단계가 포함되어 있습니다. 임의로 제거하지 마세요.
• 시세 조회처럼 읽기 전용 작업만 하는 세션이라면, 설치 시 읽기 전용 스킬(bithumb-market, bithumb-account)만 선택하세요.

제공 스킬

Bithumb Skills는 영역별로 분리한 스킬을 제공합니다. 각 스킬은 자기 영역만 담당하고, 다른 영역의 요청은 처리하지 않아 각 스킬이 맡는 역할이 구분되어 있습니다.

에이전트는 요청 내용에 따라 적절한 스킬을 자동으로 선택합니다. 아래 키워드는 각 스킬이 주로 처리하는 요청 예시입니다.

bithumb-market(시세 조회)

공개 시세 데이터를 다루는 읽기 전용 스킬입니다.

bithumb market ticker KRW-BTC
bithumb market candles-minutes KRW-BTC --unit 60 --count 24
bithumb market warnings

bithumb-account(자산 조회)

계좌 상태를 조회하는 스킬입니다.

bithumb account assets
bithumb account order-chance --market KRW-BTC
bithumb account wallet-status
bithumb system diagnose

bithumb-trade(주문)

주문 관련 작업을 담당하는 스킬입니다.

bithumb trade place \
  --market KRW-BTC --side bid --order-type limit \
  --price 50000000 --volume 0.001

bithumb twap place \
  --market KRW-BTC --side bid \
  --duration 3600 --frequency 60 --price 50000000

bithumb trade list --market KRW-BTC --state wait

bithumb-deposit(입금)

입금 작업을 담당하는 스킬입니다.

bithumb deposit address --currency BTC --net-type BTC
bithumb deposit list --currency BTC
bithumb deposit generate-address --currency BTC --net-type BTC

bithumb-withdraw(출금)

출금 작업을 담당하는 스킬입니다.

bithumb withdraw chance --currency BTC --net-type BTC
bithumb withdraw addresses
bithumb withdraw list --currency BTC

bithumb-system(진단, 실행 로그)

연결·인증 진단과 로컬 실행 로그 조회를 담당하는 읽기 전용 스킬입니다.

bithumb system diagnose
bithumb system audit --limit 10
bithumb system audit --level ERROR

문제 해결

스킬이 에이전트에서 감지되지 않을 때

• 에이전트를 재시작합니다.
• find-skills 헬퍼 스킬이 설치되어 있는지 확인합니다. 없다면 npx skills add 실행 직후 안내에 따라 추가합니다.
• npx skills list로 설치된 스킬 목록을 확인합니다.

스킬 실행 중 명령을 찾을 수 없다는 오류가 날 때

• CLI가 설치되어 있는지 확인합니다: bithumb --version
• CLI가 없다면 CLI 페이지를 참고해 설치합니다.
• bithumb system diagnose로 인증·네트워크 상태를 점검합니다.

인증 오류가 날 때

• 환경 변수 BITHUMB_ACCESS_KEY, BITHUMB_SECRET_KEY가 설정되어 있는지 확인합니다.
• 에이전트에서 환경 변수를 읽지 못하는 경우 ~/.bithumb/config.toml에 키를 등록합니다.

더 알아보기