asteroid-belt/skulto오프라인 및 보안 우선 방식으로 에이전트 스킬을 동기화하고 관리하기 위한 도구
설치 전에 AI 에이전트 스킬에서 프롬프트 인젝션을 스캔하세요
```
╔════════════════════════════════════════════════════════╗
║ ███████╗██╗ ██╗██╗ ██╗██╗ ████████╗ ██████╗ ║
║ ██╔════╝██║ ██╔╝██║ ██║██║ ╚══██╔══╝██╔═══██╗ ║
║ ███████╗█████╔╝ ██║ ██║██║ ██║ ██║ ██║ ║
║ ╚════██║██╔═██╗ ██║ ██║██║ ██║ ██║ ██║ ║
║ ███████║██║ ██╗╚██████╔╝███████╗██║ ╚██████╔╝ ║
║ ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═════╝ ║
╠════════════════════════════════════════════════════════╣
║ CROSS-PLATFORM AI SKILLS MANAGEMENT ║
╚════════════════════════════════════════════════════════╝
## Skulto란 무엇인가요?
Skulto는 33개 플랫폼에서 AI 코딩 어시스턴트 스킬을 관리하기 위한 크로스 플랫폼 CLI 도구입니다. 다음과 같은 기능을 제공합니다:
1. **멀티 플랫폼 설치** - Claude Code, Cursor, Windsurf, Copilot, Codex, Cline, Roo Code, Gemini CLI, Kiro CLI 등 25개 이상의 플랫폼에 스킬 설치
2. **저장소 관리** - 스킬 저장소 추가, 동기화, 제거
3. **전체 텍스트 검색** - 인덱싱된 모든 스킬에 대한 SQLite FTS5 기반 검색
4. **보안 스캔** - 프롬프트 인젝션 및 위험한 코드 패턴 탐지
5. **플랫폼 감지** - 시스템에 설치된 AI 도구를 자동으로 감지
6. **대화형 TUI** - Bubble Tea 기반 터미널 인터페이스로 접이식 그룹, 다중 선택, 키보드 내비게이션 지원
7. **URL 기반 설치** - `skulto install owner/repo`를 통해 GitHub 저장소에서 직접 설치
## 기능
- **33개 플랫폼 지원** - Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, OpenCode, Cline, Roo Code, Gemini CLI, Kiro CLI, Amp, Continue, Goose, Junie, Qwen Code, Trae 등
- **플랫폼 감지** - 설치된 AI 도구를 감지하여 플랫폼 선택 화면에 표시
- **오프라인 우선** - 초기 동기화 후 인터넷 없이도 작동
- **빠른 검색** - BM25 랭킹을 사용한 FTS5 기반 전체 텍스트 검색(약 50ms 지연 시간)
- **Git 기반 동기화** - 안정적인 업데이트를 위한 저장소 클론 및 풀
- **보안 스캐너** - 프론트매터, 참조, 스크립트 및 위험한 패턴에서 프롬프트 인젝션을 위협 수준과 함께 탐지
- **스마트 멀티 스킬 설치** - 저장소 URL에서 여러 스킬을 설치하고 스킬별 충돌 해결 지원(이미 설치된 항목 건너뛰기, 새 위치 추가, 모두 건너뛰기)
- **범위 선택** - 스킬을 전역(`~/`) 또는 프로젝트별(`./`)로 설치하고 플랫폼별로 개별 제어
- **접이식 플랫폼 그룹** - 감지/선호 플랫폼을 상단에 표시하고, 나머지는 모든 선택 화면에서 접힌 그룹으로 표시
- **설치 위치 기억** - 향후 설치를 위해 플랫폼/범위 선택을 선택적으로 기억
- **즐겨찾기** - 데이터베이스 초기화 후에도 유지되는 즐겨찾기 스킬 저장
- **최근 본 항목** - 최근에 본 스킬을 추적하고 표시
- **MCP 서버** - AI 도구 통합을 위한 Model Context Protocol 서버(스킬 검색, 설치, 프로그래밍 방식 관리)
- **텔레메트리** - 익명 사용 통계(설정에서 환경 변수로 비활성화 가능)
### 지원 플랫폼
Skulto는 33개의 AI 코딩 도구에 스킬을 감지하고 설치합니다:
| | | | |
|---|---|---|---|
| Claude Code | Cursor | Windsurf | GitHub Copilot |
| OpenAI Codex | OpenCode | Cline | Roo Code |
| Gemini CLI | Kiro CLI | Amp | Continue |
| Goose | Junie | Kilo Code | Trae |
| Qwen Code | Kimi Code CLI | CodeBuddy | Command Code |
| Crush | Droid | Kode | MCPJam |
| Mux | OpenHands | Pi | Qoder |
| Zencoder | Neovate | Pochi | Antigravity |
| Moltbot | | | |
## 설치
### Homebrew```bash
brew install asteroid-belt/tap/skulto
업그레이드하려면:```bash brew upgrade asteroid-belt/tap/skulto
### Linux 패키지
GitHub 릴리스는 `amd64` 및 `arm64`용 `.deb` 및 `.rpm` 다운로드를 제공합니다.
배포판에 맞는 패키지 형식을 선택하고 아래 버전을 릴리스 태그로 바꾸세요:```bash
VERSION=vX.Y.Z
ARCH=amd64 # or arm64
# Debian/Ubuntu
curl -LO "https://github.com/asteroid-belt/skulto/releases/download/${VERSION}/skulto_${VERSION#v}_linux_${ARCH}.deb"
# Fedora/RHEL/openSUSE
curl -LO "https://github.com/asteroid-belt/skulto/releases/download/${VERSION}/skulto-${VERSION#v}-1.$([ "$ARCH" = amd64 ] && echo x86_64 || echo aarch64).rpm"
# Download the release checksums, then verify the downloaded asset.
curl -LO "https://github.com/asteroid-belt/skulto/releases/download/${VERSION}/checksums.txt"
sha256sum -c checksums.txt --ignore-missing
배포판의 패키지 관리자로 로컬 파일을 설치하세요:```bash sudo apt install ./skulto_.deb sudo dnf install ./skulto-.rpm sudo zypper install ./skulto-*.rpm
각 패키지는 `skulto`와 `skulto-mcp`를 `/usr/bin/skulto` 및
`/usr/bin/skulto-mcp`에 설치합니다. Skulto는 런타임 시 시스템 Git을 요구하지 않습니다. 이들은 구성된 패키지 저장소가 아닌 GitHub Release 다운로드입니다.
### 소스에서```bash
# Clone the repository
git clone https://github.com/asteroid-belt/skulto.git
cd skulto
# Install dependencies
make deps
# Build (outputs to ./build/)
make build-all
# Run
./build/skulto
GITHUB_TOKENskulto
skulto install asteroid-belt/skills
첫 실행 시 Skulto가 온보딩 과정을 안내합니다:
1. **플랫폼 선택** - 감지된 AI 도구가 상단에 표시됩니다. 스킬을 동기화할 플랫폼을 선택하세요.
2. **스킬 선택** - Asteroid Belt에서 제공하는 큐레이션된 시작용 스킬(superplan, superbuild, teach, agentsmd-generator 등)을 선택합니다.
3. **위치 선택기** - 플랫폼별로 전역 또는 프로젝트 범위를 선택하며, 이전 선택 항목이 미리 채워져 있습니다.
## 팀을 위한 스킬 관리
Skulto는 AI 에이전트 스킬을 위한 패키지 관리자처럼 작동합니다. `skulto.json`을 사용하여 프로젝트에 필요한 스킬을 정의한 다음 `skulto sync`로 설치하면 모든 개발자와 CI 환경이 동일한 스킬 구성을 갖게 됩니다.
### 워크플로우```bash
# 1. Install skills into your project
skulto install superplan
skulto install teach
# 2. Save project skills to a manifest
skulto save
# 3. Commit skulto.json to your repo
git add skulto.json
git commit -m "add skulto skill manifest"
# 4. Teammates (or CI) sync from the manifest
skulto sync
skulto.json매니페스트는 프로젝트가 의존하는 스킬과 해당 스킬의 출처를 추적합니다:```json { "version": 1, "skills": { "superplan": "asteroid-belt/skills", "teach": "asteroid-belt/skills", "resume-ats-optimizer": "paramchoudhary/resumeskills" } }
각 항목은 스킬 슬러그를 해당 소스 저장소(`owner/repo`)에 매핑합니다. 팀원이 `skulto sync`를 실행하면 Skulto는 누락된 저장소를 클론하고, 스킬을 해석한 뒤 선택한 플랫폼에 설치합니다.
### `skulto save`
현재 프로젝트 범위의 설치 항목을 `skulto.json`에 저장합니다:```bash
$ skulto save
SAVED to skulto.json
teach asteroid-belt/skills
superplan asteroid-belt/skills
2 skill(s) saved
프로젝트 범위 설치만 저장됩니다 — 전역 설치는 개인적인 것이며 매니페스트를 통해 공유되지 않습니다.
skulto syncskulto.json을 읽고 누락된 스킬을 설치합니다:```bash
$ skulto sync
SYNCING from skulto.json (2 skills) ──────────────────────────────────────────────── Done! Installed: 2, Skipped: 0
동기화 시, Skulto는:
1. 로컬 데이터베이스에 아직 없는 소스 저장소를 추가합니다
2. 각 스킬을 슬러그(slug)로 확인합니다
3. 플랫폼 및 범위 선택을 요청합니다(`-y` 사용 시 감지된 기본값 사용)
4. 선택한 위치에 이미 설치된 스킬은 건너뜁니다
### `skulto check`
설치된 모든 스킬과 설치 위치를 표시합니다:```bash
$ skulto check
SKILL INSTALLED LOCATIONS
─────────────────────────────────────────────────────────────
superplan claude (global), codex (global + project)
teach claude (global + project)
2 skill(s) installed
skulto save와 skulto check는 모두 디스크에 존재하지만(프로젝트의 플랫폼 디렉터리에 있는 심볼릭 링크로) 데이터베이스에는 없는 스킬을 자동으로 감지합니다. 이는 마이그레이션, 데이터베이스 초기화 후, 또는 팀원이 Skulto 외부에서 스킬을 설치할 때 발생합니다.```bash
$ skulto check
RECONCILED 2 project skill(s) brainstorming claude modern-python codex
SKILL INSTALLED LOCATIONS ───────────────────────────────────────────────────────────── brainstorming claude (project) modern-python codex (project)
2 skill(s) installed
프로젝트의 일반 디렉터리(리포지토리에 직접 커밋된 스킬)는 그대로 둡니다 — Skulto 관리가 필요하지 않습니다.
## 사용법
### TUI 모드(기본값)```bash
skulto
키 바인딩:
| 키 | 동작 |
|---|---|
/ | 검색 열기 |
j / k | 아래 / 위로 이동 |
h / l | 왼쪽 / 오른쪽으로 이동 (열 사이) |
↑ / ↓ | 결과 탐색 |
Enter | 선택 / 확인 |
Space | 선택 토글 (선택기에서) |
f | 즐겨찾기 / 북마크 토글 |
i | 스킬 위치 설치 / 관리 |
c | 스킬 콘텐츠를 클립보드에 복사 |
p | 저장소 풀 / 동기화 |
Esc | 뒤로 / 취소 |
q | 종료 |
홈 화면에는 세 개의 열이 표시됩니다: