Skill para o Claude Code (e agentes compatíveis) que converte arquivos de Linear, Jira, Notion, ClickUp, Google Drive e outras fontes em um second brain para LLM: uma wiki em Markdown, organizada e versionada no GitHub.
Andrej Karpathy descreve o padrão no gist LLM Wiki. Em vez de o LLM recuperar trechos de documentos a cada pergunta (RAG), ele constrói e mantém uma wiki persistente entre você e as fontes. O conhecimento é compilado uma vez e mantido atualizado.
Três camadas, como no gist:
| Camada | Pasta | Regra |
|---|---|---|
| Fontes brutas | raw/ |
Imutáveis. O agente lê, nunca edita |
| Wiki | wiki/ |
O agente escreve e mantém, você revisa |
| Schema | AGENTS.md |
Diz ao agente como ler, escrever e manter |
Três operações: ingest (fonte nova atualiza 5 a 15 páginas), query (pergunta com citação; boa resposta vira página) e lint (contradições, órfãs, lacunas). Dois arquivos de navegação: index.md (catálogo) e log.md (cronologia).
Esta skill é uma implementação do padrão, com decisões que o gist deixa em aberto: estrutura de pastas, frontmatter tipado, wikilinks por slug, MEMORY.md para conflitos e pendências, decisões append-only e lint automático.
- Pergunta o essencial: fontes, quem usa, destino no GitHub, regras de escrita.
- Mostra a estrutura de diretório proposta e a função de cada pasta.
- Cria o scaffold (
scripts/scaffold.py). - Ingere as fontes em
raw/, com um guia por ferramenta. - Compila a
wiki/: projetos, playbooks, conceitos, decisões, pessoas. Não cria uma página por ticket. - Gera
index.md,log.mdeMEMORY.md. - Valida com
tools/lint_brain.py. - Versiona no GitHub, privado por padrão, e só publica com confirmação.
brain/
├── README.md AGENTS.md index.md MEMORY.md log.md
├── wiki/
│ ├── concepts/ rules/ playbooks/ projects/
│ ├── decisions/ people/ sources/
├── raw/
│ └── linear/ jira/ notion/ clickup/ drive/ artigos/ transcricoes/ pdfs/ assets/
├── .agent/retrieval-config.yaml
├── tools/lint_brain.py
└── .github/workflows/lint.yml
A função de cada pasta está em references/estrutura-diretorio.md.
Clone dentro da pasta de skills do projeto (ou de ~/.claude/skills/ para uso global):
git clone https://github.com/punkmetrics/second-brain-skill .claude/skills/second-brainDepois peça ao Claude, por exemplo: "converta meus exports do Jira e do Notion em um second brain no GitHub".
| Caminho | Para quê |
|---|---|
SKILL.md |
Fluxo completo da skill |
references/estrutura-diretorio.md |
Árvore proposta e a ideia de cada pasta |
references/formato-de-pagina.md |
Frontmatter, tipos, nomenclatura, wikilinks |
references/fontes/ |
Guia por fonte: Linear, Jira, Notion, ClickUp, Drive, genérico |
references/github.md |
Repositório, commits, revisão, CI, privacidade |
assets/templates/ |
Arquivos-base do scaffold |
assets/page-templates/ |
Um modelo por tipo de página |
scripts/scaffold.py |
Cria a estrutura (só biblioteca padrão do Python 3) |
scripts/lint_brain.py |
Valida frontmatter, links, órfãs, segredos e imutabilidade de raw/ |
O brain concentra conhecimento interno. Mantenha o repositório do seu brain privado, faça a triagem de dados sensíveis antes de ingerir e nunca commite segredos. O lint varre padrões comuns de token e chave, mas não substitui a revisão humana.
MIT. Veja LICENSE.
Mantido pela PunkMetrics.