# grounded-citations

Скилл grounded-citations привязывает утверждения агента к проверенным ссылкам со сквозной нумерацией в стиле Perplexity и проверяет точность цитат по сохранённому тексту.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 307 установок · ★ 265216 у репозитория
- Автор: Hermes Agent + Teknium
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NousResearch/hermes-agent/tree/HEAD/skills/research/grounded-citations/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/grounded-citations

## Что делает

Скилл создаёт строгий реестр источников через локальный скрипт `scripts/sources.py`. Когда агент ищет данные в сети, он сначала регистрирует адреса в базе, получает числовые идентификаторы вроде `[1]` и только потом пишет текст. Модель оперирует исключительно выданными номерами, поэтому не выдумывает несуществующие ссылки из памяти.

Внутри используется стандартная библиотека Python 3, дополнительные пакеты не нужны. Реестр хранится по пути `$HERMES_HOME/cache/citations/ledger.json` или в файле из параметра `--ledger`. Скрипт умеет очищать базу, прикреплять точные цитаты к источникам, выводить блок `Sources:` и запускать проверку готового черновика через `verify`.

Для академических статей с выгрузкой в BibTeX скилл не рассчитан — авторы рекомендуют передавать данные в связку с `arxiv`. Если в системе нет интерпретатора Python 3, валидация и генерация списков работать не будут.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NousResearch/hermes-agent --skill grounded-citations -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/grounded-citations/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/grounded-citations/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NousResearch/hermes-agent --skill grounded-citations -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/grounded-citations/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NousResearch/hermes-agent --skill grounded-citations -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/grounded-citations/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NousResearch/hermes-agent skills/research/grounded-citations
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/grounded-citations/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NousResearch/hermes-agent --skill grounded-citations -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/NousResearch/hermes-agent --path skills/research/grounded-citations
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/grounded-citations/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add NousResearch/hermes-agent --skill grounded-citations -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NousResearch/hermes-agent/tree/HEAD/skills/research/grounded-citations/SKILL.md

## Когда брать
- связать факты в отчёте с реальными веб-страницами через сноски
- исключить галлюцинации и выдуманные URL при сетевом поиске
- проверить совпадение цитат в черновике с исходным текстом страниц
- сгенерировать блок источников в конце документа по единому реестру

## Примеры запросов агенту
- Собери отчёт о релизе Python 3.13, регистрируй каждый найденный URL в реестре и расставь сноски к фактам
- Проверь готовый черновик draft.md через команду `sources.py verify --evidence`
- Сформируй блок Sources: в формате Markdown только для ссылок, упомянутых в тексте

## Похожие
- [content-research-and-sourcing](https://affpapa.org/nevibecode/skills/content-research-and-sourcing.md) — скилл · 1300 установок
- [research](https://affpapa.org/nevibecode/skills/danjdewhurst-research.md) — скилл · 463 установки
- [Metis Check](https://affpapa.org/nevibecode/mcp/metis-check.md) — MCP-сервер
- [Lenz Fact-Check](https://affpapa.org/nevibecode/mcp/lenz-fact-check.md) — MCP-сервер
- [paper-spine](https://affpapa.org/nevibecode/skills/paper-spine.md) — скилл · 1300 установок
- [LastSearch](https://affpapa.org/nevibecode/mcp/lastsearch.md) — MCP-сервер · ★ 20 у репозитория

Из того же набора: [nousresearch/hermes-agent](https://affpapa.org/nevibecode/by/nousresearch/hermes-agent.md) — 61 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
