### Paquets Linux

Les versions GitHub fournissent des téléchargements `.deb` et `.rpm` pour `amd64` et
`arm64`. Choisissez le format de paquet adapté à votre distribution et remplacez la
version ci-dessous par une étiquette de version :```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

Chaque paquet installe `skulto` et `skulto-mcp` dans `/usr/bin/skulto` et
`/usr/bin/skulto-mcp`. Skulto ne nécessite pas Git système au moment de l'exécution. Il s'agit
de téléchargements depuis GitHub Releases, et non d'un dépôt de paquets configuré.

### Depuis la source```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

Au premier lancement, Skulto vous guide à travers l’intégration :

1. **Sélection de la plateforme** — Les outils IA détectés apparaissent en haut ; sélectionnez ceux vers lesquels synchroniser les compétences
2. **Sélection des compétences** — Compétences de démarrage sélectionnées depuis Asteroid Belt (superplan, superbuild, teach, agentsmd-generator, et plus)
3. **Choix de l’emplacement** — Choisissez une portée globale ou par projet pour chaque plateforme, avec vos sélections précédentes pré-remplies

## Gestion des compétences pour les équipes

Skulto fonctionne comme un gestionnaire de paquets pour les compétences des agents IA. Utilisez `skulto.json` pour définir les compétences dont votre projet a besoin, puis `skulto sync` pour les installer — afin que chaque développeur et environnement CI dispose de la même configuration de compétences.

### Le flux de travail```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

Chaque entrée associe un slug de compétence à son dépôt source (`owner/repo`). Lorsqu’un coéquipier exécute `skulto sync`, Skulto clone les dépôts manquants, résout les compétences et les installe sur les plateformes sélectionnées.

### `skulto save`

Capture vos installations actuelles au niveau du projet dans `skulto.json` :```bash
$ skulto save

SAVED to skulto.json

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

2 skill(s) saved

Au moment de la synchronisation, Skulto :
1. Ajoute les dépôts sources qui ne sont pas déjà dans la base de données locale
2. Résout chaque compétence par son slug
3. Demande la sélection de la plateforme et de la portée (ou utilise les valeurs par défaut détectées avec `-y`)
4. Ignore les compétences déjà installées aux emplacements sélectionnés

### `skulto check`

Affiche toutes les compétences installées et leur emplacement d'installation :```bash
$ skulto check

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

2 skill(s) installed

Les répertoires simples dans votre projet (compétences commitées directement dans le dépôt) sont laissés tels quels — ils n'ont pas besoin de la gestion de Skulto.

## Utilisation

### Mode TUI (par défaut)```bash
skulto

Lors de l'installation depuis une URL de dépôt :
1. Skulto synchronise le dépôt et présente toutes les compétences disponibles
2. Sélectionnez les compétences à installer à l'aide d'une liste de contrôle interactive
3. Choisissez les plateformes cibles avec un sélecteur de plateformes dépliable (plateformes détectées en haut)
4. **Saut intelligent** pour les compétences déjà installées : invite avec `y` (ajouter les emplacements), `N` (ignorer, par défaut), ou `s` (ignorer toutes les suivantes)
5. Le résumé final affiche les compteurs de compétences installées, ignorées et échouées

#### `skulto add <repo>`

Ajouter un dépôt de compétences à Skulto :

![Démo d'ajout de dépôt](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

Ceci clone/met à jour tous les dépôts et réconcilie l’état des compétences installées avec le système de fichiers.

#### `skulto remove`

Supprime un dépôt et toutes ses compétences :```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 combiné + scan avec rapport :

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

Vous pouvez également basculer les favoris dans la TUI en appuyant sur `f` dans n’importe quelle vue de détail d’une compétence.

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

Skulto inclut un serveur MCP (Model Context Protocol) qui expose les compétences à Claude Code et à d’autres clients compatibles MCP. Cela permet aux assistants IA de rechercher, parcourir, installer et gérer les compétences et les dépôts de manière programmatique.

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

Ajoutez-le à vos paramètres Claude Code (`.claude.json`) :```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

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

Aucune donnée personnelle, aucune adresse IP n'est collectée. Voir plus dans [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go).

## Documentation

- [Vue d'ensemble](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) - Identité du projet et fonctionnalités clés
- [Architecture](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) - Conception du système, composants et flux de données
- [Premiers pas](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) - Prérequis, installation et première exécution
- [Développement](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) - Workflow de contribution, tests et CI/CD
- [Registre des décisions d'architecture](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) - Décisions techniques clés et justifications
- [Glossaire](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) - Terminologie du domaine

## Contribuer

Les contributions sont les bienvenues ! Veuillez d'abord lire [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md).

## Licence

Licence MIT - voir [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE) pour plus de détails.

---

Fait avec ❤️ par [Asteroid Belt](https://github.com/asteroid-belt)