연동 가이드
Agent Skill 설치
Codex와 Claude Code에 ABTO Skill을 설치하고 검증하는 방법입니다.
ABTO Agent Skill은 저장소의 런타임을 확인하고 필요한 Browser, App, Server SDK만 골라 연동합니다.
공식 공개 경로는 https://github.com/greedy-co/abto-sdk/tree/main/abto이고 Skill 이름은 abto입니다.
설치 전 확인
섹션 제목: “설치 전 확인”Node.js 22.20 이상과 npx가 필요합니다.
node --versionnpm --versionnpx --version각 에이전트가 실제 Skill 디렉터리를 갖도록 --copy를 사용합니다.
Codex
섹션 제목: “Codex”npx --yes skills@latest add https://github.com/greedy-co/abto-sdk/tree/main/abto --skill abto --global --agent codex --copy --yes설치를 확인합니다.
npx --yes skills@latest list --global --agent codex전역 설치 위치는 ~/.agents/skills/abto입니다.
처음 설치한 뒤 현재 세션에 Skill이 보이지 않으면 에이전트 세션을 다시 시작하세요.
Claude Code
섹션 제목: “Claude Code”npx --yes skills@latest add https://github.com/greedy-co/abto-sdk/tree/main/abto --skill abto --global --agent claude-code --copy --yes설치를 확인합니다.
npx --yes skills@latest list --global --agent claude-code전역 설치 위치는 ~/.claude/skills/abto입니다.
업데이트와 삭제
섹션 제목: “업데이트와 삭제”npx --yes skills@latest update abto --global --yesnpx --yes skills@latest remove abto --global --agent codex --yesnpx --yes skills@latest remove abto --global --agent claude-code --yes같은 이름의 프로젝트 로컬 Skill이 있으면 삭제하기 전에 전역·로컬 설치를 모두 확인하세요. 수정된 로컬 Skill은 차이를 확인하고 승인받기 전에는 덮어쓰지 않습니다.
문제 해결
섹션 제목: “문제 해결”npx를 찾을 수 없음
섹션 제목: “npx를 찾을 수 없음”현재 프로젝트가 이미 사용하는 버전 관리 도구로 지원되는 Node.js를 설치하세요. 별도의 버전 관리 도구를 추가하지 않습니다.
설치했지만 Skill 목록에 없음
섹션 제목: “설치했지만 Skill 목록에 없음”- 현재 에이전트에 맞는
--agent codex또는--agent claude-code를 사용했는지 확인합니다. --copy가 포함됐는지 확인합니다.- 예상 전역 설치 위치를 확인합니다.
- 해당 에이전트의
list명령을 다시 실행합니다. - 에이전트 세션을 다시 시작합니다.
설치가 끝나면 연동 시작하기로 돌아가 실제 프로젝트 연동을 진행하세요.