Ingot — версии и проверка скиллов агента
Ingot
Локальный MCP-сервер хранит скиллы как версии и пускает улучшенные варианты в работу только после проверки человеком
- 51 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер отдает агенту инструкции, и содержимое `skills/` без проверки сразу влияет на поведение агента
- Коннекторы пишут в Langfuse промпты, ответы и вызовы инструментов сессии
Установка
- Работает в
Ручная установка
git clone https://github.com/SlanchaAI/ingot.git && cd ingotЗатем `cp .env.example .env` и значение `API_KEY` или `BASE_URL` для Ollama или vLLM.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер отдает агенту инструкции, и содержимое `skills/` без проверки сразу влияет на поведение агента
- Коннекторы пишут в Langfuse промпты, ответы и вызовы инструментов сессии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ingot — локальная библиотека и MCP-сервер для скиллов агента. Каждый файл папки скилла получает хеш, поэтому версию в трассе, в отчете проверки и на диске можно сопоставить. Агент вызывает `route_and_load` в начале запроса: сервер выбирает скилл по эмбеддингам на процессоре, без GPU, и отдает текущие инструкции. Улучшенные варианты проходят карантин. Интеграция с SkillOpt берет реальные трассы агента, обучает ограниченные правки инструкций и сравнивает старую и новую версию на отложенных задачах. Итог — предложение с оценками по каждому случаю и расходом токенов. Заменить рабочий скилл может только человек: он подтверждает продвижение версии в интерфейсе. Прежняя версия сохраняется, откат доступен из интерфейса и командной строки. Команда `docker compose up` поднимает маршрутизатор на порту 8000, интерфейс на 8080 и собственный Langfuse на 3100 для трасс. Модели идут через OpenRouter или через совместимую с OpenAI конечную точку Ollama или vLLM. Для Claude Code и Codex есть скрипты `./scripts/claude_setup.sh` и `./scripts/codex_setup.sh`.
Для кого. Разработчикам, которые ведут собственную библиотеку скиллов для Claude Code или Codex и хотят проверять правки инструкций на отложенных задачах до подключения.
Подходит, если
- Скилл по Tailwind устарел, и правку хочется сначала прогнать на отложенных задачах
- Несколько агентов берут скиллы из одного места, и нужен единый сервер с версиями
- Новая версия скилла ухудшила ответы, и надо откатиться к снимку
- Решения об изменении инструкций должны оставлять локальный журнал
- В Langfuse хочется видеть, какой скилл и какая версия загрузились на запрос
Не подходит, если
- Скиллов немного, и они меняются вручную раз в месяц: стек из нескольких контейнеров не окупится
- Сервер нужен команде в общей сети: Ingot рассчитан на одного оператора, а для расширенного доступа есть отдельное руководство по защищенной установке
- Сессии содержат данные, которые нельзя сохранять в Langfuse: коннекторы пишут туда промпты, ответы и вызовы инструментов
- Docker недоступен: стек запускается через Docker Compose 2.24.4 или новее
Пример запроса к агенту
Как объединить несколько PDF в один и добавить номера страниц?MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
API_KEYсекрет- Ключ OpenRouter для размещенных моделей; вместо него можно указать `BASE_URL`
BASE_URL- Адрес совместимой с OpenAI конечной точки Ollama или vLLM
AUTH_PASSWORDсекрет- Пароль интерфейса проверки, значение по умолчанию надо сменить
INGOT_MCP_URL- Адрес MCP-сервера, если он не на localhost
Ограничения
Нужны Docker, Docker Compose 2.24.4 или новее и свободные порты 8000, 8080 и 3100. Для моделей требуется ключ OpenRouter или адрес совместимой конечной точки Ollama либо vLLM. У MCP-эндпоинта нет встроенной авторизации, а интерфейс закрыт паролем по умолчанию, и его надо сменить через `AUTH_PASSWORD`. Файлы, скопированные в `skills/` напрямую, обходят карантин и сразу становятся активными. Журнал решений локальный и от подделки не защищен.
Как отключить. Выполните `claude mcp remove ingot` и остановите стек командой `docker compose down` в каталоге проекта.
Частые вопросы
Как подключить Ingot к Claude Code?
Поднимите стек командой `docker compose up -d`, затем выполните `./scripts/claude_setup.sh`. Скрипт добавляет MCP-сервер `ingot` по адресу `http://localhost:8000/mcp` на уровне пользователя и ставит коннектор Langfuse. Параметр `--doctor` проверяет настройку без изменений.
Почему агент не вызывает Ingot сам?
Подключение сервера лишь дает доступ к инструменту. Добавьте в `CLAUDE.md` или `AGENTS.md` постоянное правило: вызывать `ingot.route_and_load` в начале запроса и следовать возвращенному `skill_body`.
Может ли SkillOpt сам заменить скилл?
Нет, он только готовит правку. Вариант попадает в `runs/pending/` и ждет решения, а заменить рабочий скилл может человек после просмотра оценок на отложенных задачах.
Какие модели подходят?
OpenRouter с ключом в `API_KEY` или Ollama и vLLM по адресу в `BASE_URL`. Вызовы OpenRouter идут с маршрутизацией без хранения данных, она включена для каждого запроса.
Нужен ли отдельный Langfuse?
Нет, `docker compose up` поднимает собственный Langfuse на порту 3100. Для Langfuse Cloud или своего проекта возьмите `docker-compose.external-langfuse.yml` и задайте переменные `LANGFUSE_*`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCLI и MCP-сервер для Agent Skills: проверка по спецификации, установка из GitHub и подгрузка нужного скилла по запросу
Meta Skill (ms)
Meta Skill
Meta Skill (ms) хранит скиллы локально в SQLite и Git, ищет по ним гибридным поиском и отдает агентам через MCP под бюджет токенов
Скилл с 25 командами для разбора и доработки промптов, инструментов и схем агентов в Cursor, Claude Code, Gemini CLI и Codex
Claude Skills MCP — поиск скиллов по смыслу
Claude Skills MCP
MCP-сервер с векторным поиском: агент описывает задачу и получает подходящие скиллы из коллекций Anthropic и K-Dense
Консольный менеджер скиллов: ставит их из маркетплейса, GitHub, приватного Git и npm в папки 45 агентов и сканирует перед установкой
CLI и MCP-сервер, которые превращают сайты документации, репозитории, PDF и видео в скиллы и данные для RAG
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ingot — версии и проверка скиллов агента (эта карточка) | да | не нужна | 51 | |
| Agent Skill Manager | нет | 966 | ищет и ставит чужие скиллы с проверкой перед установкой, а этот версионирует свои скиллы и проверяет автоматические правки | |
| Langfuse Skills | да | 333 | скиллы Langfuse учат агента настраивать трассировку, а Ingot сам использует Langfuse для трасс и управляет версиями скиллов |
Коротко о README
Ingot рассчитан на одного доверенного оператора и локальную разработку. В документации разобран полный цикл на примере устаревшего скилла по Tailwind: поиск проблемных трасс, оптимизация, проверка, продвижение версии и откат. Подробности про сеть и безопасность вынесены в отдельные руководства.