sx는 AI 스킬, MCP 서버, 에이전트, 규칙, 명령어, 훅 같은 에이전트 자산을 한 곳에서 관리하고 여러 AI 도구의 네이티브 형식으로 설치해주는 오픈소스 배포 도구다.
왜 필요한가
AI 에이전트 자산은 보통 개인 홈 디렉터리나 특정 프로젝트 저장소 안에 흩어진다. 좋은 agent-skills를 만들어도 Claude Code, Codex, Cursor, Gemini CLI 같은 도구마다 설치 위치와 형식이 다르고, 팀원이 복사해 쓰기 시작하면 버전이 금방 갈라진다.
sx는 이 문제를 vault라는 공유 원천(source of truth)으로 푼다. 사용자는 스킬이나 규칙을 vault에 추가하고, sx는 현재 사용자·저장소·경로·팀·봇 범위에 맞는 자산만 각 클라이언트 위치에 설치한다.
핵심 기능
| 영역 | 설명 |
|---|---|
| 자산 관리 | 스킬, 규칙, 에이전트, 명령어, 훅, MCP 서버, 플러그인을 vault에 등록하고 버전 관리한다. |
| 배포 범위 | 조직 전체, 특정 저장소, 특정 경로, 팀, 사용자, 봇 단위로 설치 범위를 나눈다. |
| 클라이언트 변환 | 하나의 자산을 Claude Code, Codex, Cursor, Gemini CLI 등 각 도구의 네이티브 형식으로 쓴다. |
| 관측과 감사 | sx stats로 사용 현황을 보고, sx audit로 팀·설치 변경 기록을 추적한다. |
| 운영 모델 | 로컬 폴더, Dropbox·Google Drive 같은 동기화 폴더, Git vault, Skills.new를 선택할 수 있다. |
설치와 기본 사용
macOS나 Linux에서는 Homebrew로 설치할 수 있다.
brew tap sleuth-io/tap
brew install sx공유 폴더를 팀 vault로 쓰는 최소 흐름은 다음과 같다.
sx init --type path --path ~/Dropbox/sx-vault
sx add ~/.claude/skills/my-skill
sx install이 방식은 GitHub 계정이나 별도 서버 없이 팀이 이미 쓰는 동기화 폴더를 배포 백엔드로 삼는다는 점이 특징이다. CLI에 익숙하지 않은 팀은 데스크톱 앱에서 같은 vault를 지정하고 스킬을 끌어다 놓는 방식으로 쓸 수 있다.
vault와 lock 구조
sx는 npm이나 cargo처럼 manifest와 lock 구조를 따른다.
sx.toml: vault의 원천 선언 파일이다. 관리 자산, 설치 범위, 팀 정의를 담는다.- lock 파일:
sx install이 현재 사용자와 범위를 해석해 만든 결과물이다. 사용자의 캐시 디렉터리에 저장되고, 변경 시 이전 lock을 보존한다. .sx/audit/,.sx/usage/: 설치·팀 변경 기록과 사용 이벤트를 JSONL로 남긴다.
이 구조 덕분에 팀은 “모든 자산을 항상 설치”하는 대신 필요한 범위에만 설치할 수 있다. 컨텍스트를 줄이고, 특정 저장소나 봇에만 필요한 지침이 다른 작업에 섞이는 문제도 줄어든다.
플러그인 마켓플레이스 생성
Git 또는 path vault는 Claude Code와 Codex용 플러그인 마켓플레이스로도 노출될 수 있다. sx는 publish 과정에서 .claude-plugin/marketplace.json과 .codex-plugin/plugin.json을 생성·유지한다. sx를 직접 쓰지 않는 팀원도 AI 도구의 플러그인 설치 흐름으로 필요한 컬렉션만 가져갈 수 있다.
언제 쓰면 좋은가
- 여러 프로젝트에서 같은 스킬과 에이전트 규칙을 재사용하는 팀
- 개발자와 비개발자가 함께 AI 스킬을 공유해야 하는 조직
- Claude Code, Codex, Cursor, Gemini CLI 등 여러 클라이언트를 병행하는 사용자
- CI 봇, 리뷰 봇, 문서 봇처럼 역할별 에이전트 자산을 분리해 관리하려는 팀
개인 사용자는 단순한 로컬 vault만으로도 가치가 있다. 하지만 sx가 특히 빛나는 지점은 팀 단위 배포, 범위 지정, 감사 기록이 필요한 순간이다.
라이선스
sx는 Apache-2.0 라이선스로 공개되어 있다. GitHub 저장소 기준 주 구현 언어는 Go이며, 데스크톱 앱과 CLI를 함께 제공한다.
관련 문서
- agent-skills — AI 에이전트의 능력을 확장하는 스킬 시스템
- sx-tips-dropbox-skill-server — Dropbox 공유 폴더를 팀용 AI 스킬 서버로 쓰는 방법
- awesome-agent-skills — 공식 팀과 커뮤니티가 만든 에이전트 스킬 큐레이션
참고 자료
- sleuth-io/sx — GitHub 공식 저장소