### Pacotes Linux

Os GitHub Releases fornecem downloads `.deb` e `.rpm` para `amd64` e
`arm64`. Escolha o formato de pacote para a sua distribuição e substitua a
versão abaixo por uma tag de 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

Cada pacote instala `skulto` e `skulto-mcp` em `/usr/bin/skulto` e
`/usr/bin/skulto-mcp`. O Skulto não requer Git do sistema em tempo de execução. Estes são
downloads do GitHub Release, não um repositório de pacotes configurado.

### A partir do código-fonte```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

No primeiro lançamento, o Skulto guia você pela configuração inicial:

1. **Seleção de plataforma** - As ferramentas de IA detectadas aparecem no topo; selecione quais sincronizar habilidades
2. **Seleção de habilidades** - Habilidades iniciais selecionadas do Asteroid Belt (superplan, superbuild, teach, agentsmd-generator e outras)
3. **Seletor de local** - Escolha o escopo global ou do projeto por plataforma, com suas seleções anteriores pré-preenchidas

## Gerenciamento de Habilidades para Equipes

O Skulto funciona como um gerenciador de pacotes para habilidades de agentes de IA. Use `skulto.json` para definir as habilidades que seu projeto precisa e, em seguida, `skulto sync` para instalá-las — para que todo desenvolvedor e ambiente de CI tenha a mesma configuração de habilidades.

### O Fluxo de Trabalho```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 mapeia um slug de skill para o seu repositório de origem (`owner/repo`). Quando um colega de equipe executa `skulto sync`, o Skulto clona quaisquer repositórios ausentes, resolve as skills e as instala nas plataformas selecionadas.

### `skulto save`

Captura as suas instalações atuais no escopo do projeto em `skulto.json`:```bash
$ skulto save

SAVED to skulto.json

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

2 skill(s) saved

Ao sincronizar, o Skulto:
1. Adiciona quaisquer repositórios de origem que ainda não estejam no banco de dados local
2. Resolve cada habilidade pelo slug
3. Solicita a seleção de plataforma e escopo (ou usa os padrões detectados com `-y`)
4. Ignora habilidades que já estão instaladas nos locais selecionados

### `skulto check`

Mostra todas as habilidades instaladas e onde elas estão instaladas:```bash
$ skulto check

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

2 skill(s) installed

Diretórios simples no seu projeto (skills commitados diretamente no repositório) são deixados como estão — eles não precisam de gerenciamento do Skulto.

## Uso

### Modo TUI (Padrão)```bash
skulto

Quando instalado a partir de uma URL de repositório:
1. O Skulto sincroniza o repositório e apresenta todas as habilidades disponíveis
2. Selecione quais habilidades instalar com uma lista de verificação interativa
3. Escolha as plataformas de destino com um seletor de plataformas recolhível (plataformas detectadas no topo)
4. **Pulo inteligente** para habilidades já instaladas: solicitado com `y` (adicionar locais), `N` (pular, padrão) ou `s` (pular todas as restantes)
5. O resumo final mostra as contagens de instaladas, puladas e com falha

#### `skulto add <repo>`

Adicionar um repositório de habilidades ao Skulto:

![Demonstração de Adição de Repositório](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 comando clona/atualiza todos os repositórios e reconcilia o estado das skills instaladas com o sistema de arquivos.

#### `skulto remove`

Remove um repositório e todas as suas skills:```bash
# Interactive selection
skulto remove

# Specify repository
skulto remove asteroid-belt/skills

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

Relatórios de níveis de ameaça: CRITICAL, HIGH, MEDIUM, LOW

#### `skulto update`

Pull combinado + verificação com relatórios:

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

Você também pode alternar favoritos na TUI pressionando `f` em qualquer visualização de detalhes de skill.

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

O Skulto inclui um servidor MCP (Model Context Protocol) que expõe skills ao Claude Code e a outros clientes compatíveis com MCP. Isso permite que assistentes de IA pesquisem, naveguem, instalem e gerenciem skills e repositórios programaticamente.

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

Adicione às suas configurações do Claude Code (`.claude.json`):```json
{
  "mcpServers": {
    "skulto": {
      "command": "/opt/homebrew/bin/skulto-mcp",
      "type": "stdio"
    }
  }
}

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

Nenhum dado pessoal, nenhum endereço IP é coletado. Veja mais em [events](https://github.com/asteroid-belt/skulto/blob/main/internal/telemetry/events.go).

## Documentação

- [Visão Geral](https://github.com/asteroid-belt/skulto/blob/main/docs/overview.md) - Identidade do projeto e principais recursos
- [Arquitetura](https://github.com/asteroid-belt/skulto/blob/main/docs/architecture.md) - Design do sistema, componentes e fluxo de dados
- [Primeiros Passos](https://github.com/asteroid-belt/skulto/blob/main/docs/getting-started.md) - Pré-requisitos, instalação e primeira execução
- [Desenvolvimento](https://github.com/asteroid-belt/skulto/blob/main/docs/development.md) - Fluxo de contribuição, testes e CI/CD
- [Registros de Decisões de Arquitetura](https://github.com/asteroid-belt/skulto/blob/main/docs/adr/README.md) - Principais decisões técnicas e justificativas
- [Glossário](https://github.com/asteroid-belt/skulto/blob/main/docs/glossary.md) - Terminologia do domínio

## Contribuindo

Contribuições são bem-vindas! Por favor, leia [CONTRIBUTING.md](https://github.com/asteroid-belt/skulto/blob/main/CONTRIBUTING.md) primeiro.

## Licença

Licença MIT - veja [LICENSE](https://github.com/asteroid-belt/skulto/blob/main/LICENSE) para detalhes.

---

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