BorjaGM1/kb-template

Transforma algo que o proprietário envia (texto, link, transcrição de nota de voz, screenshot) numa nota bem formatada e vinculada, no vault correto.

O que é kb-template?

Esta skill transforma qualquer tipo de entrada enviada pelo proprietário (texto, link, transcrição de nota de voz ou screenshot) numa nota devidamente formatada e vinculada dentro da base de conhecimento pessoal (Obsidian). Suporta múltiplos formatos de entrada: extrai conteúdo de links (título, autor, data e 3-7 pontos-chave), transcreve notas de voz removendo preenchimentos, processa threads longas (X, fóruns) lendo respostas completas e indicando a cobertura, e descreve/OCR screenshots armazenando imagens em `attachments/`. A skill garante que as notas sejam colocadas no vault correto (conforme tabela em AGENTS.md), evita duplicatas pesquisando notas existentes com ripgrep, e atualiza notas existentes quando apropriado. O processo inclui vinculação a notas relacionadas via wikilinks, adição a MOCs ou `Home.md`, revisão de consistência de tags e corpo em inglês, execução de linter, e commit com push imediato. A skill é ideal para utilizadores do Obsidian que desejam automatizar a captura de conhecimento, mantendo a integridade e a organização dos seus vaults.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorjaGM1/kb-template/tree/HEAD/skills/capture

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Captura

  1. A partir da raiz do repositório: git pull --rebase.
  2. Verifique o escopo (AGENTS.md): foi enviado explicitamente? Não é um tópico excluído? Remova quaisquer segredos.
  3. Extraia o conteúdo:
    • Texto: use como está, ajuste a redação, mantenha o significado.
    • Link: obtenha a página; anote título, autor, data, 3-7 pontos principais, o URL em source.
    • Voz: transcreva; mantenha a intenção do proprietário; remova preenchimentos.
    • Threads longas (X, fóruns): leia as respostas na íntegra, não trechos truncados, e além da primeira página. Em threads enormes, cubra a parte substancial (respostas do autor, respostas de alto sinal). Indique a cobertura na nota (ex.: "li 40 de 55 respostas do autor").
    • Screenshot/imagem: descreva/OCR o texto relevante; armazene a imagem em attachments/ se for útil.
  4. Escolha o vault (tabela em AGENTS.md). Se não estiver claro: vault padrão Inbox/ + uma pergunta ao proprietário.
  5. Pesquise notas existentes sobre o mesmo tópico (rg -il "<palavras-chave>" vaults/<v>). Prefira atualizar uma nota existente (atualize updated) a criar uma duplicata.
  6. Se for nova: uma nota atómica por ideia; divida se a entrada cobrir várias. Nome de ficheiro conforme AGENTS.md; frontmatter created/updated/source/tags; conteúdo e tags em inglês.
  7. Vincule-a: pelo menos um [[link]] para uma nota relacionada ou MOC, e adicione-a ao MOC relevante (ou Home.md). Se não classificada: Inbox/.
  8. Nunca invente; marque inferências.
  9. Reveja antes de fazer commit: releia o(s) rascunho(s) da(s) nota(s) juntamente com notas relacionadas/vinculadas e as tags existentes no vault (rg -h '^tags:' vaults/<v> | tr -d '[]' | tr ',' '\n' | sed 's/^ *//' | sort -u). Verifique e corrija:
    • Corpo e tags estão em inglês.
    • Tags encaixam no tópico e correspondem às notas irmãs/vinculadas.
    • Reutilize tags existentes antes de criar novas.
    • Wikilinks e entradas de MOC / Home.md estão completas.
    • Nenhum facto inventado; inferências marcadas.
  10. python3 scripts/lint.py vaults/<v>; faça commit capture(<v>): <título>; faça push imediatamente.
  11. Responda brevemente com a(s) nota(s) criada(s)/atualizada(s).

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas