sleuth-io/sx

가장 뛰어난 개발자들은 커스텀 스킬 (custom skills), MCP 설정 (MCP configs), 슬래시 명령어 (slash commands), 검증된 패턴 (proven patterns) 등을 활용하여 AI 어시스턴트를 믿을 수 없을 정도로 생산적으로 만드는 방법을 알아냈습니다. 하지만 그 지식은 각자의 컴퓨터에 갇혀 있습니다.

현재의 임시 방편들은 확장성이 없습니다:

각 저장소에 복사 (Copy into each repo) - 중복의 악몽, 중앙 업데이트 불가, 버전 불일치 (version drift)
전역 설정 (Global config) - 해당 스킬이 필요하지 않은 프로젝트나 작업에까지 컨텍스트 (context)를 불필요하게 늘림
클라이언트 플러그인 (Client plugins) - 각 플러그인을 수동으로 설치해야 하며, 특정 AI 클라이언트에 종속되고 번들링 (bundling)이 불가능함

sx는 다음과 같은 방식으로 이 문제를 해결합니다:

전문 지식 공유 (Sharing expertise) - 개인의 발견을 팀의 자산으로 전환
즉각적인 온보딩 (Instant onboarding) - 신입 개발자가 첫날부터 팀의 AI 플레이북 (playbook)을 상속받음
중앙 업데이트 (Central updates) - 볼트 (vault)에서 한 번만 변경하면 모두가 업데이트를 받음
범위 지정 설치 (Scoped installation) - 조직 (org), 팀, 봇, 저장소 (repo) 또는 개인별로 적절한 자산만 할당하여 컨텍스트 팽창을 방지
모든 AI 클라이언트와 호환 (Works with any AI client) - Claude Code, Cursor, GitHub Copilot, Gemini, Kiro, OpenCode 등을 비롯하여, 클라우드 릴레이 (cloud relay)를 통해 claude.ai 및 chatgpt.com과도 연동 가능

Homebrew를 통한 설치 (macOS/Linux):

brew tap sleuth-io/tap
brew install sx

또는 셸 스크립트 (shell script)를 통한 설치:

curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash

그 다음

# 초기화 (Initialize)
sx init
# 볼트에서 자산 추가 (Add an asset from your vault)
...

여러 개의 볼트 (Multiple vaults)? 프로필 (profiles)을 사용하여 전환할 수 있습니다:

sx profile add work # 새 프로필 추가
sx profile use work # 해당 프로필로 전환
sx profile list # 모든 프로필 확인

설치 대상 (Install targets) — 누가 어떤 자산을 볼지 선택합니다:

sx install my-skill --org # 볼트 내의 모든 구성원
sx install my-skill --repo github.com/acme/infra # 해당 저장소 내부에서만
sx install my-skill --path github.com/acme/infra#docs/ # 저장소 내 특정 경로
...

범위 (Scope)	대상 (Who gets it)
`--org`	모든 사용자 — 플래그가 설정되지 않았을 때의 기본값
`--repo` / `--path`	지정된 저장소(repo) 또는 하위 경로(subpath) 내에서 작업하는 호출자
`--team`	팀 멤버; 관리자 권한(admin-gated) 필요
`--user`	단일 사용자; 호출자의 Git 신원(git identity)과 일치해야 함
`--bot`	봇 신원; `SX_BOT=<name>`이 설정되었을 때 확인됨

전체 개요와 각 설치 대상별 범위 문서(per-scope doc) 링크는 docs/scoping.md를 참조하세요.

미리보기 (Preview) — sx install이 무엇을 해결(resolve)할지, 다운로드하거나 아무것도 작성하지 않고 pip freeze와 유사하게 확인해 보세요:

sx install --dry-run

claude.ai 또는 chatgpt.com의 Vault를 사용하세요 — skills.new 릴레이(relay)를 통해 MCP 엔드포인트(endpoint)로 노출합니다:

sx cloud connect # skills.new를 열고, 다시 붙여넣을 연결(attach) 라인을 붙여넣으세요
sx cloud serve # 이 명령을 계속 실행하세요 — Ctrl+C로 종료합니다
sx cloud status # claude.ai / chatgpt.com에 붙여넣을 MCP URL을 출력합니다

릴레이는 사용자의 머신이 여는 WebSocket을 통해 요청을 전달하며, Vault 콘텐츠는 로컬에 유지됩니다. docs/cloud-relay.md를 참조하세요.

사용 분석 및 감사 (Usage analytics & audit):

sx stats # 도입 현황 대시보드 (adoption dashboard)
sx stats --since 7d --json # 기계 판독 가능 (machine-readable) 형식
sx audit # 최근 팀/설치 변경 사항 (mutations)
...

.claude 디렉토리에 스킬(skills), 플러그인(plugins) 또는 MCP 설정을 구축해 두었다면, sx는 이를 버전 관리하고, 머신 간에 동기화하며, 팀원들과 공유할 수 있도록 도와줍니다.

# 기존 스킬/명령어를 추가합니다 (sx가 유형을 자동 감지합니다)
sx add ~/.claude/commands/my-command
sx add ~/.claude/skills/my-skill
...

사용자의 프롬프트 파일은 있는 그대로 유지됩니다. sx는 단지 버전 관리를 위해 메타데이터(metadata)로 이를 감싸는(wrap) 역할만 수행합니다.

Skills (기술)

특정 작업을 위한 커스텀 프롬프트(prompts) 및 동작(behaviors)
Rules (규칙)
특정 파일 유형이나 경로에 적용되는 코딩 표준 및 가이드라인
Agents (에이전트)
특정 목표를 가진 자율 AI 에이전트(Autonomous AI agents)
Commands (명령어)
빠른 작업을 위한 슬래시 명령어(Slash commands)
Hooks (훅)
라이프사이클 이벤트(lifecycle events)를 위한 자동화 트리거
MCP Servers (MCP 서버) (실험적 기능) - 외부 통합을 위한 Model Context Protocol (MCP) 서버
Plugins (플러그인)
명령어, 기술 등을 포함한 Claude Code 플러그인 번들

sx는 85,000개 이상의 에이전트 기술이 담긴 커뮤니티 디렉토리인 skills.sh와 통합됩니다.

sx add anthropics/skills/frontend-design # 특정 기술 추가
sx add vercel-labs/agent-skills # 리포지토리(repo) 내 기술 탐색
sx add --browse # 전체 디렉토리 검색 및 탐색

팀에 적합한 배포 모델을 선택하세요:

여러 개인 프로젝트 간에 개인 도구를 쉽게 공유하기에 완벽합니다.

sx init --type path --path my/vault/path

공유된 git 볼트(vault)를 통해 자산을 공유합니다.

sx init --type git --repo git@github.com:yourteam/skills.git

발견, 생성, 공유 및 사용 분석을 위한 UI를 갖춘 중앙 집중식 관리 방식입니다.

sx init --type sleuth

sx는 npm, cargo, uv에서 사용하는 매니페스트 및 락(manifest-and-lock) 패턴을 따릅니다:

Manifest (매니페스트) — 볼트의 신뢰할 수 있는 원천(source of truth). 관리되는 모든 자산, 설치 범위(sx.toml 내의 org, repo, path, team, bot, user), 그리고 팀 정의(멤버, 관리자, 리포지토리)를 나열합니다. git 또는 경로 볼트에 커밋됩니다. docs/manifest-spec.md를 참조하세요.

Lock file (락 파일) — 사용자별로 해결된 결과물(resolved artifact). sx install은 매니페스트를 읽고, 호출자의 git 신원(identity)을 기준으로 팀 및 사용자 범위를 해결(resolve)한 뒤, 그 결과를 사용자의 캐시 디렉토리(~/<cache>/sx/lockfiles/)에 기록합니다. 해결된 락(lock)이 변경되면, 이전 파일은 타임스탬프와 함께 로테이션되어 이전 설치 상태를 재현(reproducible)할 수 있도록 유지됩니다.

Audit + usage streams (감사 및 사용 스트림) — 모든 팀/설치 변경 사항은 .sx/audit/YYYY-MM.jsonl에 감사 항목을 추가하며, 사용 이벤트는 .sx/usage/YYYY-MM.jsonl에 추가됩니다. sx audit 또는 sx stats 명령어로 이를 조회할 수 있습니다.

상위 수준 요약: 메타데이터가 포함된 에셋(assets)을 **생성(create)**하고, 자신의 볼트(vault)에 **공유(share)**하며,
조직(org), 팀(team), 봇(bot), 사용자(user), 저장소(repo), 경로(path)별로 또는 전역(globally)으로 **설치(install)**할 수 있습니다.
새로운 Claude Code 세션에서 **자동 설치(auto-install)**되고 **동기화 상태를 유지(stay synchronized)**하므로 —
모든 사용자가 자동으로 동일한 도구를 갖게 됩니다.

클라이언트 (Client)	상태 (Status)	비고 (Notes)
Claude Code	✅ 지원됨 (Supported)	모든 에셋 유형에 대한 완전한 지원
...

✅ 로컬(Local), Git, 그리고 Skills.new 볼트 (vaults)
✅ Claude Code 지원
✅ Cline 지원
✅ Cursor 지원
✅ GitHub Copilot 지원
✅ Gemini 지원
✅ Codex 지원
✅ Kiro 지원
✅ Openclaw 지원
✅ OpenCode 지원
✅ skills.new 클라우드 릴레이(cloud relay)를 통한 claude.ai 및 chatgpt.com 지원
✅ 모든 볼트 유형에 대한 조직(Org), 팀(Team), 봇(Bot), 저장소(Repository) 및 개인(Personal) 설치 대상 지원
✅ 스킬 발견 (Skill discovery) - Skills.new를 사용하여 코드와 아키텍처로부터 관련 스킬을 발견
✅ 분석 (Analytics) - 스킬 사용량 및 영향력 추적
RBAC 및 변경 요청 흐름 (change request flow) - 게이트가 적용된 스킬 업데이트 흐름 지원

자세한 내용은 LICENSE 파일을 참조하세요.

클릭하여 개발 지침 확장

Vault 명세 (Vault Spec) - 볼트 디렉토리 구조
Manifest 명세 (Manifest Spec) - sx.toml 소스 오브 트루스(source-of-truth) 형식 (에셋, 범위, 팀)
Lock 명세 (Lock Spec) - 사용자별로 해결된 락 파일 (lock file)
범위 지정 (Scoping) - 설치 대상 및 범위별 문서 링크 (조직, 저장소, 팀, 사용자, 봇)
감사 로그 (Audit log) - 이벤트 카탈로그, sx audit 필터, 저장 형식
사용량 분석 (Usage analytics) - sx stats 대시보드, JSON 출력, 이벤트 형식
메타데이터 명세 (Metadata Spec) - 에셋 메타데이터 형식
MCP 명세 (MCP Spec) - MCP 서버 및 쿼리 도구
프로필 (Profiles) - 다중 구성 프로필
클라이언트 (Clients) - 클라이언트 지원 모델 및 IDE 대 CLI 제한 사항
클라우드 릴레이 (Cloud relay) - skills.new를 통해 claude.ai 및 chatgpt.com에 볼트 노출

Go 1.25 이상 버전이 필요합니다. gvm을 사용하여 설치하세요:

# gvm 설치
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
# Go 설치 (필요한 경우 go1.4를 부트스트랩으로 사용)
...

make init # 최초 설정 (도구 설치, 의존성 다운로드)
make build # 바이너리 빌드 (Build binary)
make install # GOPATH/bin에 설치 (Install to GOPATH/bin)

make test # 레이스 탐지 (race detection)와 함께 테스트 실행
make format # gofmt로 코드 포맷팅 (Format code with gofmt)
make lint # golangci-lint 실행
...

GoReleaser를 통한 자동 릴리스 (automated release)를 트리거하려면 태그를 지정하고 푸시하세요:

git tag v0.1.0
git push origin v0.1.0

sleuth-io/sx

요약

핵심 포인트

클릭하여 개발 지침 확장

댓글