К основному содержанию
скилл CX Codex

rag-architect · vasallo94 — скилл для Claude Code: что делает и как установить

Скилл rag-architect для правок пайплайна RAG на LangGraph: узлы графа, гибридный retrieval и промпты LLM.

MIT 1 установок ★ 127 обновлён 2026-09-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Vasallo94/ObsidianRAG --skill rag-architect -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/rag-architect/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rag-architect/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

rag-architect https://github.com/Jeffallan Скилл rag-architect проектирует RAG-системы: разбивает документы на чанки, генерирует эмбеддинги, настраивает векторные базы, строит гибридный поиск и оценивает качество извлечения контекста. CX Codex +1 5 100установок rag-architect Alireza Rezvani Скилл rag-architect для Claude Code проектирует RAG-пайплайн по документам и проверяет качество поиска. Помогает выбирать разбиение на чанки, эмбеддинги и векторную базу. CX Codex +1 629установок rag-architect borghei Скилл rag-architect для Claude Code и Cursor проектирует конвейеры RAG и подбирает параметры разбиения текста. Оценивает качество поиска по метрикам Recall@K и MRR на реальных запросах. CX Codex +1 137установок veritasgraph bibinprathap MCP-сервер veritasgraph для Claude Code и других агентных сред, который отвечает на вопросы по графу знаний с обязательными ссылками на источники. Работает полностью локально через Ollama или через облачные API. CX Codex +1 ★ 326звёзд репо rag-implementation Seth Hobson Скилл rag-implementation для Claude Code помогает собирать RAG-системы с векторным поиском и ответами LLM по внешним документам. Решает задачи Q&A и ассистентов по базе знаний. CX Codex +1 13 906установок haiku.rag ggozad MCP-сервер haiku.rag индексирует документы и отвечает на вопросы с указанием страниц и разделов. Подключите его, чтобы искать по своим файлам прямо через ИИ-агента. CX Codex +1 ★ 665звёзд репо neo4j-graphrag-skill neo4j-contrib Строит GraphRAG-пайплайны на Neo4j через Python-пакет neo4j-graphrag. Помогает выбрать ретривер и связать его с LLM. CX Codex +1 1 200установок wiki-query Ar9av Скилл wiki-query ищет ответы по скомпилированной базе Obsidian через графовый индекс и синтезирует выводы с цитатами без изменения заметок. CX Codex +1 3 600установок langchain-rag langchain-ai Скилл langchain-rag даёт ИИ-агенту готовые шаблоны и код для сборки RAG-пайплайнов на LangChain в Python и TypeScript: от загрузки документов до векторного поиска. CX Codex +1 18 600установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой