### Пакеты Linux

Релизы на GitHub предоставляют загрузки `.deb` и `.rpm` как для `amd64`, так и для
`arm64`. Выберите формат пакета для вашего дистрибутива и замените
версию ниже на тег релиза:```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. **Выбор платформы** — обнаруженные ИИ-инструменты отображаются вверху; выберите, к каким из них синхронизировать навыки
2. **Выбор навыков** — подобранные стартовые навыки из Asteroid Belt (superplan, superbuild, teach, agentsmd-generator и другие)
3. **Выбор области применения** — укажите глобальную или проектную область для каждой платформы, с предзаполненными предыдущими выборами

## Управление навыками для команд

Skulto работает как менеджер пакетов для навыков ИИ-агентов. Используйте `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. Разрешает каждый навык по слагу
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

При установке из URL-адреса репозитория:
1. Skulto синхронизирует репозиторий и показывает все доступные навыки
2. Выберите, какие навыки установить, с помощью интерактивного чек-листа
3. Выберите целевые платформы с помощью сворачиваемого выбора платформ (обнаруженные платформы — вверху)
4. **Умный пропуск** уже установленных навыков: запрос с `y` (добавить расположения), `N` (пропустить, по умолчанию) или `s` (пропустить все оставшиеся)
5. Итоговая сводка показывает количество установленных, пропущенных и неудачных навыков

#### `skulto add <repo>`

Добавить репозиторий навыков в Skulto:

![Демонстрация добавления репозитория](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 включает MCP-сервер (Model Context Protocol), который предоставляет навыки клиентам Claude Code и другим совместимым с MCP клиентам. Это позволяет ИИ-ассистентам выполнять поиск, просмотр, установку и управление навыками и репозиториями программным способом.

![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)