### Linux-Pakete

GitHub-Releases bieten `.deb`- und `.rpm`-Downloads für sowohl `amd64` als auch
`arm64` an. Wählen Sie das Paketformat für Ihre Distribution und ersetzen Sie
die Version unten durch ein Release-Tag:```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

Jedes Paket installiert `skulto` und `skulto-mcp` unter `/usr/bin/skulto` und
`/usr/bin/skulto-mcp`. Skulto benötigt zur Laufzeit kein systemweites Git. Diese
Downloads stammen von GitHub Releases, nicht aus einem konfigurierten Paket-Repository.

### Aus dem Quellcode```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

Beim ersten Start führt dich Skulto durch die Einrichtung:

1. **Plattformauswahl** – Erkannte KI-Tools erscheinen oben; wähle aus, zu welchen Skills synchronisiert werden sollen
2. **Skill-Auswahl** – Kuratierte Starter-Skills aus dem Asteroid Belt (superplan, superbuild, teach, agentsmd-generator und weitere)
3. **Ortsauswahl** – Wähle globalen oder Projektbereich pro Plattform, mit deinen vorherigen Auswahlen vorausgefüllt

## Skill-Verwaltung für Teams

Skulto funktioniert wie ein Paketmanager für KI-Agenten-Skills. Verwende `skulto.json`, um die Skills zu definieren, die dein Projekt benötigt, und führe dann `skulto sync` aus, um sie zu installieren – so haben jeder Entwickler und jede CI-Umgebung dieselbe Skill-Einrichtung.

### Der Workflow```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

Jeder Eintrag ordnet einen Skill-Slug seinem Quell-Repository (`owner/repo`) zu. Wenn ein Teammitglied `skulto sync` ausführt, klont Skulto fehlende Repositories, löst die Skills auf und installiert sie auf den ausgewählten Plattformen.

### `skulto save`

Erfasst deine aktuellen projektbezogenen Installationen in `skulto.json`:```bash
$ skulto save

SAVED to skulto.json

  teach               asteroid-belt/skills
  superplan           asteroid-belt/skills

2 skill(s) saved

Bei der Synchronisierung führt Skulto Folgendes aus:
1. Fügt alle Quell-Repositories hinzu, die noch nicht in der lokalen Datenbank vorhanden sind
2. Löst jede Fertigkeit anhand ihres Slugs auf
3. Fragt nach Plattform- und Umfangsauswahl (oder verwendet erkannte Standardwerte mit `-y`)
4. Überspringt Fertigkeiten, die an den ausgewählten Speicherorten bereits installiert sind

### `skulto check`

Zeigt alle installierten Fertigkeiten und deren Installationsorte an:```bash
$ skulto check

SKILL                  INSTALLED LOCATIONS
─────────────────────────────────────────────────────────────
superplan              claude (global), codex (global + project)
teach                  claude (global + project)

2 skill(s) installed

Plain-Verzeichnisse in deinem Projekt (Skills, die direkt ins Repo committet sind) bleiben unberührt – sie benötigen keine Skulto-Verwaltung.

## Verwendung

### TUI-Modus (Standard)```bash
skulto

Wenn die Installation über eine Repository-URL erfolgt:
1. Skulto synchronisiert das Repository und zeigt alle verfügbaren Skills an
2. Wähle aus, welche Skills mit einer interaktiven Checkliste installiert werden sollen
3. Wähle Zielplattformen mit einem aufklappbaren Plattform-Auswahlmenü (erkannte Plattformen oben)
4. **Intelligentes Überspringen** für bereits installierte Skills: Abfrage mit `y` (Standorte hinzufügen), `N` (überspringen, Standard) oder `s` (alle restlichen überspringen)
5. Die abschließende Zusammenfassung zeigt installierte, übersprungene und fehlgeschlagene Anzahlen

#### `skulto add <repo>`

Fügt ein Skill-Repository zu Skulto hinzu:

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

Dies klont/aktualisiert alle Repositories und gleicht den installierten Skill-Zustand mit dem Dateisystem ab.

#### `skulto remove`

Entfernt ein Repository und alle seine Skills:```bash
# Interactive selection
skulto remove

# Specify repository
skulto remove asteroid-belt/skills

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

Meldet Bedrohungsstufen: KRITISCH, HOCH, MITTEL, NIEDRIG

#### `skulto update`

Kombinierter Pull + Scan mit Berichterstattung:

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

Sie können Favoriten in der TUI auch umschalten, indem Sie in einer beliebigen Skill-Detailansicht `f` drücken.

### MCP-Server (`skulto-mcp`)

Skulto enthält einen MCP-Server (Model Context Protocol), der Skills für Claude Code und andere MCP-kompatible Clients bereitstellt. Dies ermöglicht KI-Assistenten, Skills und Repositories programmatisch zu durchsuchen, zu browsen, zu installieren und zu verwalten.

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

Fügen Sie dies zu Ihren Claude-Code-Einstellungen hinzu (`.claude.json`):```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

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

Keine persönlichen Daten, keine IP-Adressen werden erfasst. Weitere Informationen finden Sie in [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go).

## Dokumentation

- [Überblick](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) – Projektidentität und Hauptfunktionen
- [Architektur](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) – Systemdesign, Komponenten und Datenfluss
- [Erste Schritte](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) – Voraussetzungen, Installation und erster Start
- [Entwicklung](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) – Beitrags-Workflow, Tests und CI/CD
- [Architektur-Entscheidungsprotokolle](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) – Wichtige technische Entscheidungen und Begründungen
- [Glossar](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) – Fachterminologie

## Mitwirken

Beiträge sind willkommen! Bitte lesen Sie zuerst [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md).

## Lizenz

MIT-Lizenz – Details siehe [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE).

---

Mit ❤️ erstellt von [Asteroid Belt](https://github.com/asteroid-belt)