skill-vault

Central de skills, rules e workflows para agentes de IA.

O que e

O skill-vault agrega skills de multiplas fontes da comunidade e skills customizadas em um unico repositorio. Todas as skills sao indexadas automaticamente no catalog.json, que serve como catalogo centralizado para consumo pelo agent-kit-mcp.

Estrutura de diretorios

skill-vault/
├── sources/        # Git submodules (read-only) de repos externos
├── custom/         # Skills customizadas do usuario (editavel)
├── rules/          # Templates CLAUDE.md por tipo de projeto
├── bundles/        # Grupos pre-definidos de skills por contexto
├── scripts/        # Scripts de sync e geracao do catalogo
├── catalog.json    # Indice auto-gerado (nao editar manualmente)
└── .github/
    └── workflows/
        └── sync.yml

Fontes incluidas

Fonte	Repositorio
anthropics	github.com/anthropics/courses
cursor-rules	github.com/PatrickJS/awesome-cursorrules
claude-rules	github.com/sanjeed5/awesome-claude-rules
prompts-community	github.com/x1xhlol/system-prompts-and-models-of-ai-tools
ai-workflows	github.com/ai-boost/awesome-prompts
fabric-patterns	github.com/danielmiessler/fabric

Como usar

Rodar o sync manualmente

./scripts/sync.sh

Consultar o catalogo

Total de skills indexadas:

cat catalog.json | jq '.total'

Filtrar skills por fonte:

cat catalog.json | jq '[.skills[] | select(.source == "anthropics")]'

Como adicionar um novo submodule

git submodule add <url> sources/<nome>

Depois, rode o sync para atualizar o catalogo:

./scripts/sync.sh

Como criar uma custom skill

1. Crie uma pasta dentro de custom/:

mkdir custom/minha-skill

2. Adicione um arquivo SKILL.md com frontmatter:

---
name: minha-skill
description: Descricao breve da skill
---

Conteudo da skill aqui.

3. Rode o sync para indexar no catalogo.

Estrutura do catalog.json

Exemplo de uma entrada no catalogo:

{
  "total": 150,
  "generated_at": "2026-03-28T06:00:00Z",
  "skills": [
    {
      "name": "example-skill",
      "source": "anthropics",
      "path": "sources/anthropics/example-skill",
      "description": "Descricao da skill",
      "tags": ["ai", "prompt"]
    }
  ]
}

Sync automatico

O GitHub Actions executa o workflow de sync toda segunda-feira as 6h UTC. O workflow:

1. Atualiza todos os submodules para a versao mais recente
2. Regenera o catalog.json
3. Faz commit e push automaticamente se houver mudancas

Tambem e possivel disparar o sync manualmente pela aba Actions no GitHub.