Agent 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 --version
npm --version
npx --version

Skill 설치

쓰는 에이전트를 고르세요. 각 에이전트가 실제 Skill 디렉터리를 갖도록 --copy를 붙입니다.

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입니다. 처음 설치한 뒤 Skill이 보이지 않으면 Claude Code 세션을 다시 시작하세요.

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이 보이지 않으면 Codex 세션을 다시 시작하세요.

에이전트에 연동 맡기기

설치가 끝나면 연동할 프로젝트에서 에이전트를 열고 다음 요청을 그대로 전달하세요.

에이전트에 보낼 요청

ABTO 스킬로 이 프로젝트의 AI 호출 하나를 연결해 주세요.
공식 문서에서 현재 환경의 설치법과 예제를 읽고 설치된 SDK 버전과 대조해 주세요.
기존 LangChain 체인이나 추적 도구가 있다면 유지해 주세요.
적용 후 호출을 실행하고 ABTO 요청 목록에서 같은 기능의 기록을 확인해 주세요.
확인하지 못한 단계와 필요한 키나 권한은 따로 알려 주세요.

요청부터 첫 기록까지는 이렇게 진행됩니다.

단계	일어나는 일
Skill 설치	에이전트에 ABTO 연동 지침이 추가됩니다. 앱 코드나 대시보드 데이터는 아직 바뀌지 않습니다.
연동 요청	에이전트가 저장소를 읽고 필요한 SDK와 수집 지점을 제안합니다. 승인한 지점에만 초기화, 호출, 이벤트 코드를 넣습니다.
앱 실행	첫 Calling 요청이 요청 화면에 나타나고 해당 기능이 사이드바에 추가됩니다. 전송한 이벤트는 성과 지표 화면에 나타납니다.

첫 호출을 확인했다면 연동 시작하기 순서대로 모델 변경과 사용자 행동 연결을 이어 갑니다. 전송과 화면 반영 시점은 이벤트 설계에서 확인할 수 있습니다.

업데이트와 삭제

업데이트

npx --yes skills@latest update abto --global --yes

Claude Code

삭제

npx --yes skills@latest remove abto --global --agent claude-code --yes

Codex

삭제

npx --yes skills@latest remove abto --global --agent codex --yes

같은 이름의 프로젝트 로컬 Skill이 있으면 삭제하기 전에 전역과 로컬 설치를 모두 확인하세요. 수정한 로컬 Skill은 차이를 확인하고 승인받기 전에는 덮어쓰지 않습니다.

문제 해결

npx를 찾을 수 없음

현재 프로젝트가 이미 쓰는 버전 관리 도구로 지원되는 Node.js를 설치하세요. 별도의 버전 관리 도구를 추가하지 않습니다.

설치했지만 Skill 목록에 없음

1. 지금 쓰는 에이전트에 맞는 --agent claude-code 또는 --agent codex를 썼는지 확인합니다.
2. --copy가 들어 있는지 확인합니다.
3. 위에 적은 전역 설치 위치에 abto 디렉터리가 있는지 확인합니다.
4. 해당 에이전트의 설치 확인 명령을 다시 실행합니다.
5. 에이전트 세션을 다시 시작합니다.