IMA 코파일럿
텐센트 IMA 공식 스킬을 한 번에 설치·진단·수리하고 지식베이스 통합 검색까지 도와주는 래퍼 스킬입니다.
유틸리티중급★ 1,323⑂ 212AI 점수 7/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 원커맨드 설치: 텐센트 IMA 공식 스킬(ima-skill) 최신 릴리스를 내려받아 Claude Code, Codex, OpenClaw 중 설치된 에이전트에만 자동 배포합니다.
- API 키 설정 안내:
~/.config/ima/에 client_id / api_key를 600 권한으로 저장하고, 실제 API 호출로 자격 증명이 유효한지 즉시 검증합니다. - 알려진 버그 진단·복구:
diagnose.sh로 읽기 전용 점검을 돌려 "Skipped loading skill(s) due to invalid SKILL.md" 같은 YAML 프론트매터 누락 문제를 찾아냅니다. 수정 전에는 반드시 사용자에게 선택지를 물어보고, 원본을 백업한 뒤 되돌릴 수 있는 명령까지 알려줍니다. - 팬아웃 검색: IMA OpenAPI에 지식베이스 통합 검색 기능이 없다는 한계를 클라이언트 측 병렬 호출로 우회하고, 우선순위 KB와 100건 잘림 현상을 함께 처리합니다.
이런 분께 추천
- 텐센트 IMA(ima.qq.com)를 쓰면서 노트·지식베이스를 Claude Code에서 다루고 싶은 분
- ima-skill 설치가 실패하거나 로딩 경고가 떠서 원인을 못 찾고 있는 분
- 여러 지식베이스를 한 번에 검색하고, 자주 쓰는 KB를 위로 올리고 싶은 분
활용 예시
- "ima 좀 설치해줘" → 설치 스크립트를 실행해 감지된 에이전트에만 배포하고, 이어서 API 키 발급 페이지 안내까지 진행합니다.
- "ima 스킬이 로딩 안 된다" →
diagnose.sh결과를 표로 보여주고, 프론트매터 누락 이슈에 대해 A/B/건너뛰기 전략을 제시한 뒤 동의를 받아 백업과 함께 수정합니다. - "내 지식베이스 전체에서 '분기 매출 보고서' 찾아줘" → 접근 가능한 모든 KB를 열거해 병렬 검색하고, 우선순위 KB 결과를 상단에 묶어 보여주며 100건 잘림 여부도 알려줍니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 ima-copilot 폴더를 내 ~/.claude/skills/ima-copilot/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/ima-copilot ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다 (macOS는 터미널, Windows는 WSL 권장).
- 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 이 스킬만 복사합니다:
cp -r claude-code-skills/ima-copilot ~/.claude/skills/ - Claude Code를 재시작하고
/skills등으로ima-copilot이 목록에 보이는지 확인합니다. - Claude Code에서 "ima 상태 진단해줘"라고 입력해
diagnose.sh가 정상 동작하는지 확인합니다. - 아직 IMA 자격 증명이 없다면 https://ima.qq.com/agent-interface 에서 Client ID와 API Key를 발급받아 안내대로
~/.config/ima/에 저장합니다. - 팬아웃 검색 개인화를 원하면
config-template/copilot.json.example을~/.config/ima/copilot.json으로 복사해 우선순위 KB를 적어 둡니다.
GitHub에서 원본 보기 ↗라이선스: MIT