### Paquetes de Linux

Los lanzamientos de GitHub proporcionan descargas `.deb` y `.rpm` tanto para `amd64` como para
`arm64`. Elige el formato de paquete para tu distribución y reemplaza la
versión a continuación con una etiqueta de lanzamiento:```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

Cada paquete instala `skulto` y `skulto-mcp` en `/usr/bin/skulto` y
`/usr/bin/skulto-mcp`. Skulto no requiere Git del sistema en tiempo de ejecución. Estas son
descargas de GitHub Release, no un repositorio de paquetes configurado.

### Desde el código fuente```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 primer inicio, Skulto te guía a través de la configuración inicial:

1. **Selección de plataforma** - Las herramientas de IA detectadas aparecen en la parte superior; selecciona a cuáles sincronizar las habilidades
2. **Selección de habilidades** - Habilidades iniciales seleccionadas del Cinturón de Asteroides (superplan, superbuild, teach, agentsmd-generator y más)
3. **Selector de ubicación** - Elige el ámbito global o de proyecto por plataforma, con tus selecciones anteriores ya rellenadas

## Gestión de Habilidades para Equipos

Skulto funciona como un gestor de paquetes para las habilidades de los agentes de IA. Usa `skulto.json` para definir las habilidades que tu proyecto necesita y luego `skulto sync` para instalarlas, de modo que cada desarrollador y entorno de CI tenga la misma configuración de habilidades.

### El Flujo de Trabajo```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

Cada entrada asigna un slug de habilidad a su repositorio fuente (`owner/repo`). Cuando un compañero ejecuta `skulto sync`, Skulto clona los repositorios faltantes, resuelve las habilidades y las instala en las plataformas seleccionadas.

### `skulto save`

Captura tus instalaciones actuales del ámbito del proyecto en `skulto.json`:```bash
$ skulto save

SAVED to skulto.json

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

2 skill(s) saved

Al sincronizar, Skulto:
1. Añade cualquier repositorio fuente que aún no esté en la base de datos local
2. Resuelve cada habilidad por slug
3. Solicita la selección de plataforma y alcance (o usa los valores predeterminados detectados con `-y`)
4. Omite las habilidades que ya están instaladas en las ubicaciones seleccionadas

### `skulto check`

Muestra todas las habilidades instaladas y dónde están instaladas:```bash
$ skulto check

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

2 skill(s) installed

Los directorios simples en tu proyecto (skills confirmados directamente en el repositorio) se dejan intactos: no necesitan gestión de Skulto.

## Uso

### Modo TUI (Predeterminado)```bash
skulto

Cuando se instala desde una URL de repositorio:
1. Skulto sincroniza el repositorio y presenta todas las habilidades disponibles
2. Selecciona qué habilidades instalar con una lista de verificación interactiva
3. Elige las plataformas objetivo con un selector de plataformas plegable (plataformas detectadas en la parte superior)
4. **Omisión inteligente** para habilidades ya instaladas: se solicita con `y` (añadir ubicaciones), `N` (omitir, predeterminado) o `s` (omitir todas las restantes)
5. El resumen final muestra los recuentos de instaladas, omitidas y fallidas

#### `skulto add <repo>`

Añade un repositorio de habilidades a Skulto:

![Demostración de Añadir Repositorio](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

Este clona/actualiza todos los repositorios y reconcilia el estado de las habilidades instaladas con el sistema de archivos.

#### `skulto remove`

Elimina un repositorio y todas sus habilidades:```bash
# Interactive selection
skulto remove

# Specify repository
skulto remove asteroid-belt/skills

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

Informa los niveles de amenaza: CRÍTICO, ALTO, MEDIO, BAJO

#### `skulto update`

Combinación de pull + escaneo con informes:

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

También puedes alternar favoritos en la TUI presionando `f` en cualquier vista de detalle de habilidad.

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

Skulto incluye un servidor MCP (Model Context Protocol) que expone habilidades a Claude Code y otros clientes compatibles con MCP. Esto permite que los asistentes de IA busquen, naveguen, instalen y gestionen habilidades y repositorios de forma programática.

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

Añádelo a tu configuración de Claude Code (`.claude.json`):```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

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

No se recopilan datos personales ni direcciones IP. Consulta más información en [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go).

## Documentación

- [Descripción general](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) - Identidad del proyecto y características clave
- [Arquitectura](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) - Diseño del sistema, componentes y flujo de datos
- [Primeros pasos](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) - Requisitos previos, instalación y primera ejecución
- [Desarrollo](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) - Flujo de trabajo para contribuciones, pruebas y CI/CD
- [Registros de decisiones de arquitectura](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) - Decisiones técnicas clave y su justificación
- [Glosario](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) - Terminología del dominio

## Contribuciones

¡Las contribuciones son bienvenidas! Lee primero [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md).

## Licencia

Licencia MIT - consulta [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE) para más detalles.

---

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