### Pacchetti Linux

Le GitHub Releases forniscono download `.deb` e `.rpm` sia per `amd64` che per
`arm64`. Scegli il formato del pacchetto per la tua distribuzione e sostituisci la
versione qui sotto con un tag di release:```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

Ogni pacchetto installa `skulto` e `skulto-mcp` in `/usr/bin/skulto` e
`/usr/bin/skulto-mcp`. Skulto non richiede Git di sistema in fase di esecuzione. Questi sono
download da GitHub Release, non un repository di pacchetti configurato.

### Dal sorgente```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

Al primo avvio, Skulto ti guida attraverso la configurazione iniziale:

1. **Selezione della piattaforma** - Gli strumenti AI rilevati appaiono in cima; seleziona quelli a cui sincronizzare le skill
2. **Selezione delle skill** - Skill iniziali curate da Asteroid Belt (superplan, superbuild, teach, agentsmd-generator e altre)
3. **Scelta della posizione** - Scegli l'ambito globale o di progetto per ogni piattaforma, con le selezioni precedenti già precompilate

## Gestione delle Skill per i Team

Skulto funziona come un gestore di pacchetti per le skill degli agenti AI. Usa `skulto.json` per definire le skill di cui il tuo progetto ha bisogno, poi `skulto sync` per installarle — così ogni sviluppatore e ambiente CI ha la stessa configurazione di skill.

### Il Flusso di Lavoro```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

Ogni voce associa uno slug di skill al suo repository sorgente (`owner/repo`). Quando un membro del team esegue `skulto sync`, Skulto clona eventuali repository mancanti, risolve le skill e le installa sulle piattaforme selezionate.

### `skulto save`

Cattura le installazioni correnti a livello di progetto in `skulto.json`:```bash
$ skulto save

SAVED to skulto.json

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

2 skill(s) saved

Al sync, Skulto:
1. Aggiunge eventuali repository sorgente non già presenti nel database locale
2. Risolve ogni skill tramite slug
3. Richiede la selezione di piattaforma e ambito (oppure usa i valori predefiniti rilevati con `-y`)
4. Salta le skill già installate nelle posizioni selezionate

### `skulto check`

Mostra tutte le skill installate e dove sono installate:```bash
$ skulto check

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

2 skill(s) installed

I progetti in directory semplici (skill committate direttamente nel repository) vengono lasciati invariati — non necessitano della gestione di Skulto.

## Utilizzo

### Modalità TUI (predefinita)```bash
skulto

Quando si installa da un URL di repository:
1. Skulto sincronizza il repository e presenta tutte le skill disponibili
2. Seleziona quali skill installare con un elenco interattivo a caselle di spunta
3. Scegli le piattaforme di destinazione con un selettore di piattaforme comprimibile (piattaforme rilevate in alto)
4. **Salto intelligente** per le skill già installate: viene richiesto con `y` (aggiungi percorsi), `N` (salta, predefinito) o `s` (salta tutte le rimanenti)
5. Il riepilogo finale mostra i conteggi di installate, saltate e non riuscite

#### `skulto add <repo>`

Aggiungi un repository di skill a Skulto:

![Demo Aggiunta Repository](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

Questo clona/aggiorna tutti i repository e riconcilia lo stato delle skill installate con il filesystem.

#### `skulto remove`

Rimuove un repository e tutte le sue skill:```bash
# Interactive selection
skulto remove

# Specify repository
skulto remove asteroid-belt/skills

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

Reports threat levels: CRITICAL, HIGH, MEDIUM, LOW

#### `skulto update`

Pull combinato + scansione con report:

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

Puoi anche attivare/disattivare i preferiti nella TUI premendo `f` su qualsiasi vista dei dettagli di una skill.

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

Skulto include un server MCP (Model Context Protocol) che espone le skill a Claude Code e ad altri client compatibili con MCP. Questo consente agli assistenti AI di cercare, sfogliare, installare e gestire skill e repository in modo programmatico.

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

Aggiungi alle impostazioni di Claude Code (`.claude.json`):```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

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

Nessun dato personale, nessun indirizzo IP viene raccolto. Per maggiori dettagli, consulta [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go).

## Documentazione

- [Panoramica](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) - Identità del progetto e funzionalità principali
- [Architettura](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) - Progettazione del sistema, componenti e flusso dei dati
- [Per iniziare](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) - Prerequisiti, installazione e prima esecuzione
- [Sviluppo](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) - Flusso di lavoro per i contributi, test e CI/CD
- [Architecture Decision Records](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) - Decisioni tecniche chiave e relative motivazioni
- [Glossario](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) - Terminologia di dominio

## Contributi

I contributi sono benvenuti! Leggi prima [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md).

## Licenza

Licenza MIT - consulta [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE) per i dettagli.

---

Realizzato con ❤️ da [Asteroid Belt](https://github.com/asteroid-belt)