claude-plugins/gestao/skills/hub-search/SKILL.md

name, description

name	description
hub-search	Pesquisa no vault Hub Obsidian com relevance scoring e backlinks. Layer 1 da arquitectura RAG trinity (CLI → NotebookLM → LightRAG). Usar quando: (1) pesquisar conteúdo no Hub por termo ou conceito, (2) encontrar notas relacionadas via backlinks, (3) localizar PROCs/QR/docs antes de executar tarefas, (4) verificar se existe documentação antes de criar.

/hub-search — Pesquisa no Hub (Layer 1 RAG)

Pesquisa rápida no vault Hub via Obsidian CLI. Requer Obsidian aberto. Fallback automático para Grep se Obsidian não estiver a correr.

---

Uso

/hub-search "termo"
/hub-search "LightRAG configuração" --backlinks
/hub-search "PROC-MCP" --files

---

Workflow

Passo 1 — Tentar via Obsidian CLI

# Pesquisa básica
obsidian search query="TERMO" format=json

# Com backlinks (recomendado para conceitos)
obsidian search query="TERMO" format=json
obsidian backlinks file="NOTA"

# Limitar resultados
obsidian search query="TERMO" limit=10 format=json

Indicador de sucesso: saída JSON com results array. Indicador de falha: mensagem unable to find Obsidian → ir para fallback.

Passo 2 — Fallback: Grep no Hub

Se CLI falhar (Obsidian fechado):

Grep "TERMO" /media/ealmeida/Dados/Hub/ --type md

Adicionar contexto ao utilizador: "Obsidian não está a correr — usando busca directa nos ficheiros."

Passo 3 — Apresentar resultados

Formato de output:

## Resultados: "[termo]"

**Fonte:** Obsidian CLI v1.12.7 | **Backlinks:** Sim/Não

### Encontrado em N notas

| Nota | Path | Relevância |
|------|------|-----------|
| [título] | `path/relativo.md` | Alta/Média/Baixa |

### Notas com backlinks para este termo
- `nota-a.md` → referencia `nota-b.md`

### Relacionados sugeridos
- [links relevantes encontrados nos resultados]

---

Regras

1. Sempre tentar CLI primeiro — é mais preciso (scoring semântico)
2. --include-backlinks por defeito quando o termo é um conceito (não um comando)
3. Fallback silencioso — não perguntar, só mencionar que usou Grep
4. Max 10 resultados — se mais, mostrar top 10 por relevância
5. Paths relativos na apresentação (ex: 04-Stack/02.03-IA/ não path absoluto)

---

Integração com RAG Trinity

/hub-search "termo"          → Layer 1: Obsidian CLI (este skill)
/knowledge "termo"           → Layer 2: NotebookLM (58 notebooks)
mcp__lightrag__lightrag_query → Layer 3: LightRAG (conteúdo externo)

Quando escalar para Layer 2 ou 3:

• Resultado CLI score < 50% ou 0 resultados → sugerir /knowledge
• Conteúdo externo (PDFs, transcripts) → sugerir LightRAG diretamente

---

Referência CLI

# Sintaxe correcta: parâmetros com = (não flags com --)
obsidian search query="TERMO" format=json
obsidian search query="TERMO" limit=10 format=json
obsidian backlinks file="NOTA"
obsidian tags sort=count counts
obsidian tasks daily todo
obsidian version
obsidian help   # lista todos os comandos disponíveis

Nota: A skill oficial kepano (obsidian-cli) tem referência completa de todos os comandos.

Requer: Obsidian aberto + CLI activado em Settings → General → Advanced Wrapper: ~/.local/bin/obsidian (define XDG_RUNTIME_DIR Flatpak) Docs: 04-Stack/02.03-IA/Obsidian-CLI.md

---

Skill v1.0.0 | 06-04-2026 | Descomplicar®

---

Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

{"date":"","issue":"","fix":"","source":"user|auto"}

Adicionar nova linha após cada erro corrigido.