### 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

각 패키지는 `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

첫 실행 시 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

각 항목은 스킬 슬러그를 해당 소스 저장소(`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는:
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 관리가 필요하지 않습니다.

## 사용법

### TUI 모드(기본값)```bash
skulto

When installing from a repository URL:
1. Skulto syncs the repository and presents all available skills
2. Select which skills to install with an interactive checklist
3. Choose target platforms with a collapsible platform chooser (detected platforms at top)
4. **Smart skip** for already-installed skills: prompted with `y` (add locations), `N` (skip, default), or `s` (skip all remaining)
5. Final summary shows installed, skipped, and failed counts

#### `skulto add <repo>`

Add a skill repository to Skulto:

![Add Repository Demo](https://assets.kitploit.com/production/public/readmes/54493/fe7ab73f41c9aa7e9ea530b39181d92596ea95963a16ceefde64171be397d429/3e5dde043bf3159163799df1e931c2e3c2ea76591923f601bb97b6e4c24427ed-display-v1.webp)```bash
# Short format
skulto add asteroid-belt/skills

# Full URL
skulto add https://github.com/asteroid-belt/skills

# Skip initial sync
skulto add asteroid-belt/skills --no-sync

이 명령은 모든 저장소를 클론/업데이트하고 설치된 스킬 상태를 파일 시스템과 조정합니다.

#### `skulto remove`

저장소와 해당 스킬을 모두 제거합니다:```bash
# Interactive selection
skulto remove

# Specify repository
skulto remove asteroid-belt/skills

# Skip confirmation
skulto remove asteroid-belt/skills --force

위협 수준 보고: CRITICAL, HIGH, MEDIUM, LOW

#### `skulto update`

보고 기능을 포함한 결합된 pull + 스캔:

![Update Demo](https://assets.kitploit.com/production/public/readmes/54493/54bf55b9be4e247af9e17a29ba4739e3cba103eedcb81853dee0a7b9dc77e78c/f00783b728e42a565fe6d9d0fa14b29fff50d30b7a6213918248cd59a28a06bb-display-v1.webp)```bash
# Update and scan new/updated skills
skulto update

# Update and scan ALL skills
skulto update --scan-all

TUI에서 스킬 상세 보기에서 `f`를 눌러 즐겨찾기를 전환할 수도 있습니다.

### MCP 서버 (`skulto-mcp`)

Skulto에는 스킬을 Claude Code 및 기타 MCP 호환 클라이언트에 노출하는 MCP(Model Context Protocol) 서버가 포함되어 있습니다. 이를 통해 AI 어시스턴트가 스킬과 저장소를 프로그래밍 방식으로 검색, 탐색, 설치 및 관리할 수 있습니다.

![MCP Add Repository](https://assets.kitploit.com/production/public/readmes/54493/3458e3ce9bce458490070c0424855b426897c726f3694b2f59a03bc5db659a8d/fdd88daa0cf280d01530f28830e770f0fc3687e1738724663e059b1dd1e1b149-display-v1.webp)

![MCP Install Skill](https://assets.kitploit.com/production/public/readmes/54493/b82941461095032cad9db75ff8c1ab3ebfab50fcbcda8252b13899ea36891e57/31e98e150b5238987da10e4f3d89bea9d70996f8bc74208641bbcce324044133-display-v1.webp)

Claude Code 설정(`.claude.json`)에 추가하세요:```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

## 아키텍처```
skulto/
├── cmd/skulto/              # Main CLI entry point
├── cmd/skulto-mcp/          # MCP server binary
├── internal/
│   ├── cli/                 # Cobra CLI commands (add, install, pull, etc.)
│   │   └── prompts/         # Interactive CLI prompts (platform selector)
│   ├── config/              # Configuration (env vars only)
│   ├── db/                  # GORM + SQLite + FTS5 database layer
│   ├── detect/              # AI tool detection on system
│   ├── embedding/           # Embedding provider abstraction
│   ├── favorites/           # File-based favorites persistence
│   ├── installer/           # Skill installation via symlinks (33 platforms)
│   ├── llm/                 # LLM provider abstraction
│   ├── log/                 # Structured logging
│   ├── mcp/                 # MCP server implementation
│   ├── migration/           # Database migrations
│   ├── models/              # Data structures (Skill, Tag, Source, etc.)
│   ├── scraper/             # GitHub scraping (git clone based)
│   ├── search/              # Search service
│   ├── security/            # Security scanner for skills
│   ├── telemetry/           # PostHog analytics (opt-in)
│   ├── testutil/            # Test utilities
│   ├── tui/                 # Bubble Tea TUI
│   │   ├── components/      # Reusable UI components (dialogs, selectors)
│   │   └── views/           # Screen views (home, search, detail, onboarding, manage)
│   └── vector/              # Vector store
├── pkg/version/             # Version info (set via ldflags)
└── scripts/                 # Build and release scripts

개인 데이터나 IP 주소는 수집되지 않습니다. 자세한 내용은 [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go)를 참조하세요.

## 문서

- [개요](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) - 프로젝트 정체성 및 주요 기능
- [아키텍처](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) - 시스템 설계, 구성 요소 및 데이터 흐름
- [시작하기](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) - 사전 요구 사항, 설치 및 첫 실행
- [개발](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) - 기여 워크플로우, 테스트 및 CI/CD
- [아키텍처 결정 기록](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) - 주요 기술 결정 및 근거
- [용어집](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) - 도메인 용어

## 기여

기여는 언제나 환영합니다! 먼저 [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md)를 읽어주세요.

## 라이선스

MIT 라이선스 - 자세한 내용은 [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE)를 참조하세요.

---

[Asteroid Belt](https://github.com/asteroid-belt)가 ❤️로 제작했습니다.