rag-architect · vasallo94 — скилл для Claude Code: что делает и как установить
Скилл rag-architect для правок пайплайна RAG на LangGraph: узлы графа, гибридный retrieval и промпты LLM.
MIT 1 установок ★ 127 обновлён 2026-09-18
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a claude-codeЧто делает rag-architect
Скилл подключает Claude Code и похожие ассистенты к архитектуре RAG-агента на LangGraph: граф состояния AgentState идёт по пути START → retrieve → generate → END. Узел retrieve сочетает гибридный поиск через EnsembleRetriever, опциональный reranker и расширение GraphRAG — функция expand_linked_documents находит [[wikilinks]] в найденных заметках и добавляет связанные документы в контекст. Узел generate собирает промпт из этого контекста и обращается к Ollama через ChatOllama.
Для отладки скилл советует поднять уровень логирования до DEBUG в utils/logger.py или смотреть промежуточное состояние графа напрямую. Логика retrieve-узла привязана к файлам obsidianrag/core/qa_agent.py и qa_service.py, если проект разделён на модули — без этой структуры советы скилла не применить буквально.
Какие задачи решает
- изменить логику поиска контекста между BM25, вектором и reranker-ом
- добавить новый узел в граф LangGraph
- настроить расширение контекста по wikilinks из Obsidian
- переписать системный промпт LLM с цитированием источников
- найти, какие документы возвращает retrieve-узел, при отладке
Примеры запросов агенту
- Перепиши retrieve-узел так, чтобы reranker подключался только при пустом результате BM25
- Добавь обработку случая «не знаю ответа» в промпт generate-узла
- Расширь expand_linked_documents, чтобы учитывать вложенные wikilinks
Как установить rag-architect
1Через Skills CLI (Vercel)
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a claude-code2Вручную: положить файлы
~/.claude/skills/rag-architect/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rag-architect/
1Через Skills CLI (Vercel)
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a codex2Вручную: положить файлы
.agents/skills/rag-architect/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a cursor2Вручную: положить файлы
.cursor/skills/rag-architect/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Vasallo94/ObsidianRAG .agent/skills/rag-architect2Вручную: положить файлы
.github/skills/rag-architect/SKILL.md1Через Skills CLI (Vercel)
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a gemini-cli2Командой платформы
gemini skills install https://github.com/Vasallo94/ObsidianRAG --path .agent/skills/rag-architectВручную: положить файлы
.devin/skills/rag-architect/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о rag-architect
Как установить rag-architect в Claude Code?
Выполните npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a claude-code — скилл появится в ~/.claude/skills/rag-architect/SKILL.md.
Что делает rag-architect?
Скилл описывает устройство RAG-пайплайна на LangGraph: узлы retrieve и generate, гибридный поиск, расширение контекста по wikilinks и промпты LLM через Ollama.
С каким проектом работает rag-architect?
Скилл ссылается на конкретные файлы вроде obsidianrag/core/qa_agent.py, то есть рассчитан на пайплайн в духе ObsidianRAG с узлами LangGraph и ChatOllama.
Исходный текст
SKILL.md · MIT
--- name: rag-architect description: > Usa esta skill para diseñar y modificar el pipeline de RAG, incluyendo LangGraph, retrieval híbrido, GraphRAG y prompts de LLM. tools: ['read', 'edit', 'run_command'] --- # RAG & LangGraph Architect ## Cuándo usar esta skill - Cuando necesites modificar el flujo de preguntas y respuestas. - Cuando quieras cambiar la lógica de retrieval (BM25, Vector, Reranker). - Cuando ajustes los prompts del sistema o del LLM. - Cuando implementes nuevos nodos en el grafo de LangGraph. ## Cómo usar esta skill ### 1. Arquitectura del Grafo El agente usa `LangGraph` con el estado `AgentState`. **Flujo**: `START` -> `retrieve` -> `generate` -> `END` ### 2. Implementación de Nodos #### Retrieve Node Usa búsqueda híbrida (EnsembleRetriever) + Reranker opcional + Expansión de GraphRAG (wikilinks). - Ubicación: `obsidianrag/core/qa_agent.py` y `qa_service.py` (si existe split). #### Generate Node Construye el prompt con contexto formateado y llama a Ollama via `ChatOllama`. ### 3. GraphRAG Link Expansion La función clave es `expand_linked_documents`. Busca notas enlazadas mediante `[[wikilinks]]` en los documentos recuperados y las añade al contexto. ### 4. Prompt Engineering Los prompts están definidos como `ChatPromptTemplate`. - Sé explícito sobre el rol. - Pide citas de las notas fuente. - Maneja el caso "No lo sé". ### 5. Debugging Para ver qué documentos se recuperan, puedes ajustar el nivel de log a DEBUG en `utils/logger.py` o inspeccionar el estado intermedio del grafo.
© Vasallo94 · MIT · Vasallo94/ObsidianRAG
Похожие скиллы
Все скиллы по теме «ИИ и ML» →Сначала — rag-architect от других авторов.