FAISS Similarity Search
Orchestra-Research/AI-Research-SKILLs
Sets up FAISS for fast nearest-neighbor search over large collections of dense vectors, choosing between Flat, IVF, HNSW and product quantization indexes.
Portuguese guide to building a retrieval-augmented generation assistant over a company's documents, with embeddings, section-based chunking, retrieval and a client workflow.
SKILL.md written in Portuguese; this summary is our English description.
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimento --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/rag-assistente-conhecimento .claude/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .claude/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimentoType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimento --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/rag-assistente-conhecimento .agents/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .agents/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimento --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/rag-assistente-conhecimento .cursor/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .cursor/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Hermes-brasil/hermes-brasil.git --path skills/rag-assistente-conhecimento--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimento --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/rag-assistente-conhecimento .gemini/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .gemini/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimentoInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/rag-assistente-conhecimento .github/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .github/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Hermes-brasil/hermes-brasil rag-assistente-conhecimento --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/rag-assistente-conhecimento .opencode/skills/rag-assistente-conhecimento && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "rag-assistente-conhecimento" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/rag-assistente-conhecimento into .opencode/skills/rag-assistente-conhecimento/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "rag-assistente-conhecimento", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
rag-assistente-conhecimentoPortuguese guide to building a retrieval-augmented generation assistant over a company's documents, with embeddings, section-based chunking, retrieval and a client workflow.
This skill explains RAG, a technique that lets an AI answer from external knowledge such as documents, FAQs and company databases instead of generic model knowledge. It lays out the pipeline of ingestion and indexing (splitting into chunks and generating embeddings), lists advanced techniques such as multi-query, RAG fusion and query translation, and covers embeddings and similarity measures: cosine by default, plus Euclidean and dot product.
A key lesson is to chunk by thematic sections, using the second-level headings and prefixing each chunk with its title, instead of by word count, which mixes topics and retrieves the wrong section. For Brazilian Portuguese it recommends a multilingual MiniLM sentence-transformers model, and the same model must embed both documents and questions. It adds a workflow for real clients (gather FAQs, policies and catalog, structure the content, test with real questions, define when to hand over to a human) and reference pricing for selling the work as a service. The text is in Portuguese.
Read from SKILL.md and the folder at commit 8f94818. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
RAG Company Knowledge Assistant loads about 1.1k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 214 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from Hermes-brasil/hermes-brasil at commit 8f94818, republished under its MIT licence (© Hermes-brasil). 214 words, ~1,106 tokens.
.claude/skills/rag-assistente-conhecimento/SKILL.md (or your agent's skills folder).O que é: técnica que permite IA acessar conhecimento EXTERNO (documentos, FAQ, banco de dados da empresa) para dar respostas precisas e baseadas nos dados do cliente — em vez de respostas genéricas do modelo.
📋 PIPELINE DE RAG:
├── 1. INGESTÃO: carregar documentos
├── 2. INDEXAÇÃO: dividir em chunks + gerar embeddings
├── 3. RETRIEVAL: buscar chunks relevantes à pergunta
└── 4. GERAÇÃO: modelo responde usando o contexto recuperado├── Query Translation: melhorar a pergunta antes de buscar
│ ├── Multi-Query (várias versões da pergunta)
│ ├── RAG Fusion (combina resultados)
│ ├── Decomposition (quebra pergunta complexa)
│ ├── Step Back (pergunta mais geral)
│ └── HyDE (gera resposta hipotética para buscar)
├── Routing: direcionar pergunta ao modelo/fluxo certo
├── Indexing avançado: RAPTOR, ColBERT
├── CRAG (Conditional RAG): corrigir retrieval com base no grau de confiança
└── Adaptive RAG: decide quando buscar mais dados ou responder diretoparaphrase-multilingual-MiniLM-L12-v2 (entende português)from sentence_transformers import SentenceTransformer
modelo = SentenceTransformer("paraphrase-multilingual-MiniLM-L12-v2")
doc = modelo.encode("Horário de funcionamento da clínica")
pergunta = modelo.encode("A que horas abre?")NÃO dividir por contagem de palavras (mistura assuntos e recupera seção errada).
Dividir por SEÇÕES temáticas (títulos ##), cada seção vira um chunk com
o título prefixado como contexto: f"{titulo}: {corpo}". Isso mantém cada
chunk coerente e a busca fica muito mais precisa.
def chunking_por_secoes(texto):
"""Divide texto em seções (##) em vez de cortar por palavras."""
secoes = []
atual = {"titulo": "geral", "corpo": []}
for linha in texto.splitlines():
if linha.startswith("## "):
if atual["corpo"]:
secoes.append(atual)
atual = {"titulo": linha[3:].strip(), "corpo": []}
elif linha.strip():
atual["corpo"].append(linha.strip())
if atual["corpo"]:
secoes.append(atual)
return [f"{s['titulo']}: {' '.join(s['corpo'])}" for s in secoes if s["corpo"]]import numpy as np
def buscar(pergunta, chunk_embeddings, textos, top_k=3):
q = modelo.encode(pergunta)
scores = [np.dot(q, c) / (np.linalg.norm(q) * np.linalg.norm(c)) for c in chunk_embeddings]
melhores = np.argsort(scores)[-top_k:][::-1]
return [(textos[i], scores[i]) for i in melhores]⚙️ IMPLEMENTAÇÃO:
├── 1. Levantar os documentos do cliente (FAQ, políticas, catálogo)
├── 2. Estruturar o conteúdo (seções claras)
├── 3. Rodar chunking + embeddings
├── 4. Testar busca com perguntas reais
├── 5. Conectar geração (API do modelo)
├── 6. Integrar ao canal (WhatsApp/site)
├── 7. Testar respostas e ajustar
├── 8. Definir limite (quando passar para humano)
└── 9. Manutenção e atualização do conhecimento💰 PRECIFICAÇÃO:
├── Chatbot básico: R$ 1.000-3.000
├── Assistente RAG completo: R$ 3.000-8.000
├── Assistente avançado (multi-função): R$ 8.000-15.000
├── Manutenção mensal: R$ 500-2.000
└── Licença/uso recorrente: R$ 300-1.500/mês© Hermes-brasil, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/rag-assistente-conhecimento of Hermes-brasil/hermes-brasil.
Open the folder on GitHubat commit 8f94818
RAG Company Knowledge Assistant next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| RAG Company Knowledge Assistant this skillHermes-brasil/hermes-brasil | 154 | — | ~1.1k | Automated safety check: Pass | MIT | |
| FAISS Similarity SearchOrchestra-Research/AI-Research-SKILLs | 13k | 6 repos | ~1.3k | Automated safety check: Pass | MIT | |
| Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs | 13k | 7 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Sentence Transformers EmbeddingsOrchestra-Research/AI-Research-SKILLs | 13k | 2 repos | ~1.6k | Automated safety check: Pass | MIT | |
| Retail Product Search Agentgoogle/adk-recipes | 10k | — | ~3k | Automated safety check: Pass | Apache-2.0 | |
| DBoracle/skills | 877 | — | ~1.4k | Automated safety check: Pass | UPL-1.0 |
Orchestra-Research/AI-Research-SKILLs
Sets up FAISS for fast nearest-neighbor search over large collections of dense vectors, choosing between Flat, IVF, HNSW and product quantization indexes.
Orchestra-Research/AI-Research-SKILLs
Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.
Orchestra-Research/AI-Research-SKILLs
Generates text embeddings locally with the sentence-transformers library for RAG, semantic search, clustering and similarity, with model picks for general, multilingual and legal text.
google/adk-recipes
Builds a retail product search agent on Google Cloud, from catalog ingestion into BigQuery and Vector Search to ADK scaffolding, evaluation and Cloud Run deployment.
oracle/skills
Oracle Database guidance for SQL, PL/SQL, SQLcl, ORDS, Oracle Vector SDK, administration, app development, performance, security, migrations, and agent-safe database workflows.
langchain-ai/langchain-skills
INVOKE THIS SKILL when building ANY retrieval-augmented generation (RAG) system.
Hermes-brasil/hermes-brasil
A runbook, written in Portuguese, for keeping Hermes Agent healthy on a VPS: updates, gateway restarts, health checks and hosts without a systemd user bus.
Hermes-brasil/hermes-brasil
Portuguese notes on a podcast interview with a Nous Research co-founder about Hermes Agent: memory over models, self-improvement, anti-sycophancy and open source.
Hermes-brasil/hermes-brasil
Runs a project on one Kanban board shared by people and AI agents, where a dispatcher splits goals into tasks and any task can go to either a human or an agent.
Hermes-brasil/hermes-brasil
Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.
Hermes-brasil/hermes-brasil
Use quando precisar de pesquisa multi-persona com síntese protegida por evidências.
Hermes-brasil/hermes-brasil
Tratar conteúdo externo não confiável antes de agir. An agent skill from Hermes-brasil/hermes-brasil.
Categories
Portuguese guide to building a retrieval-augmented generation assistant over a company's documents, with embeddings, section-based chunking, retrieval and a client workflow. This skill explains RAG, a technique that lets an AI answer from external knowledge such as documents, FAQs and company databases instead of generic model knowledge. It lays out the pipeline of ingestion and indexing (splitting into chunks and generating embeddings), lists advanced techniques such as multi-query, RAG fusion and query translation, and covers embeddings and similarity measures: cosine by default, plus Euclidean and dot product.
RAG Company Knowledge Assistant fits situations like: building a chatbot that answers from a company's own FAQ and policies; choosing how to split documents into chunks for retrieval; setting up local multilingual embeddings for Portuguese content.
Run `npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a claude-code`. Or copy the skill folder (skills/rag-assistente-conhecimento in Hermes-brasil/hermes-brasil) into .claude/skills/rag-assistente-conhecimento in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a codex`. Or copy the skill folder (skills/rag-assistente-conhecimento in Hermes-brasil/hermes-brasil) into .agents/skills/rag-assistente-conhecimento in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Hermes-brasil/hermes-brasil --skill rag-assistente-conhecimento -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rag-assistente-conhecimento, .gemini/skills/rag-assistente-conhecimento, .github/skills/rag-assistente-conhecimento and .opencode/skills/rag-assistente-conhecimento in your project.
SKILL.md names no scripts, command-line tools or credentials: RAG Company Knowledge Assistant is instructions for the agent only. Our summary lists: Python with sentence-transformers and NumPy; The client's documents, such as FAQ, policies and catalog.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
RAG Company Knowledge Assistant is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with RAG Company Knowledge Assistant: FAISS Similarity Search (Orchestra-Research/AI-Research-SKILLs, 13k stars), Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), Sentence Transformers Embeddings (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Retail Product Search Agent (google/adk-recipes, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Hermes-brasil (a GitHub organization) maintains it in Hermes-brasil/hermes-brasil, which has 154 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 5, 2026.
Source: Hermes-brasil/hermes-brasil on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.