Answer questions from the user's own files and chat/mail archives through the AutoRAG MCP tools. Use when the user asks to find, summarize, compare, or verify something in local documents (PDF, DOCX, PPTX, XLSX, HWP/HWPX, Markdown, email) or in connected Slack, Discord, Telegram, WhatsApp, KakaoTalk, email, Notion, or Obsidian archives. Not for web search and not for first-time setup (use the setup skill).
96%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
AutoRAG indexes the user's local folders and chat/mail archives in place and
returns ranked, source-labelled chunks. This plugin runs it as a local stdio MCP
server named autorag; Hermes exposes its tools as mcp__autorag__<tool> with
dots turned into underscores (for example autorag.search is
mcp__autorag__autorag_search). The server does retrieval only. You, the
model, read the chunks and write the answer.
Use the AutoRAG tools, not the terminal. Do not open the user's files, crawler
databases, or ~/.autorag with terminal, read_file, or sqlite3 to answer a
question: the tools return the same content with sources, and stay inside the
access the user configured. Hermes lists MCP tools lazily, so first find them
with tool_search (query autorag) and read their schemas with tool_describe.
index-not-ready, or no folder is configured, switch to the
setup skill. Do not guess folders.autorag.datasources.list once per task to learn which archives exist
and what each covers. Every listed datasource has its own tool
autorag.search_datasource_<id>; the <id> is lower-cased with every run of
non-alphanumerics collapsed to _.autorag.search with {"query": "...", "topK": 8}. It fuses every
configured method and datasource.datasourceIds: ["<id>"] to
autorag.search (local files are then left out unless local: true).
local: false with no datasourceIds searches every archive but no
files. datasourceIds: [] with local: true searches files only; a bare
local: true does not narrow anything.autorag.search.files.number, source,
method, score, metadata, and content. Search with 2-3 differently
worded queries when the first results do not contain the answer; retrieval
is lexical + semantic, not a reasoning step.[1], [2]), and do not write any special markup or directive for
sources: plain text only, since not every surface renders anything else. If
sources disagree, say so and show both values with their sources and dates. If
nothing relevant came back, say that; do not fill the gap from memory.autorag.report with the query and a report object
persists the curated answer; autorag.evidence with the returned sessionId
re-reads the exact chunks behind each result. Use them when the user asks for
a verifiable answer. Read each tool's schema from the tool list; do not
invent fields.isError: true with errorCode: "index-not-ready": nothing has been indexed
yet. Run autorag.refresh (see below) or use the setup skill.embedding-unavailable: search ran keyword-only because the local
embedding daemon is off. Results are still valid. Mention it once and offer to
turn it on (the setup skill, step 5). Do not treat it as an error.stale: true or stale-index diagnostics: files changed since the last
refresh. The answer may miss new content. Tell the user, and call
autorag.refresh if they want fresh results. strict: true makes search
fail instead of answering from a stale index.unsearched: sources that were skipped or failed. ok: true with a non-empty
unsearched is partial coverage; say which sources were not searched.diagnostics with a datasource-* code: that archive's CLI is missing or
failing. Report the message verbatim; do not retry in a loop.autorag.refresh (arguments {}) re-indexes changed sources incrementally.
The first run downloads local models and can take many minutes. It reads
sources and writes only AutoRAG's own index directories; it never edits the
user's files. Narrow it with {"methods": ["parsed", "minsync"]} or
{"methods": ["datasources"]}. Use {"force": true} only after a failed or
corrupted run. Ask before a forced refresh.autorag.refresh is absent when the server runs read-only
(AUTORAG_MCP_READ_ONLY=true). Then tell the user to refresh from a terminal.autorag.duplicates scans the configured roots for exact duplicate files and
near-duplicate document families. It is read-only. Present the families and
let the user decide; never move or delete files on your own.autorag.convert converts files to another format (docx to pdf, heic to jpg, hwp to docx, md to html). Ask
autorag.convert.formats with from first when unsure a route exists. It writes new files only; it never
replaces an existing one, so say where the copy went. The result lists a Dupey verdict per output: exact or
near means the copy would be grouped as a duplicate of its source, which is expected and not a problem. Convert
only paths the user named; do not convert a folder the user did not point at. It is absent in read-only mode.Marker-Inc-Korea/AutoRAG
399c591
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.