Разработчики начали активно использовать специализированные текстовые файлы для оптимизации взаимодействия LLM с документацией проектов. Файлы `llms.txt` и `skill.md` решают разные задачи: первый служит для индексации контента и предоставления контекста модели, а второй фокусируется на описании конкретных навыков и возможностей агента, помогая ему эффективнее выбирать инструменты для выполнения поставленных задач.

Файл `llms.txt` стал де-факто стандартом для передачи структурированной информации о базе кода или документации. Он позволяет моделям быстро ориентироваться в API, правилах и архитектуре проекта, минимизируя галлюцинации за счет предоставления актуальных данных в сжатом виде. Это критически важно для RAG-систем и автономных агентов, работающих с большими репозиториями.

В свою очередь, `skill.md` выступает как своего рода «манифест способностей». Он описывает, какие действия агент может совершать, какие параметры ожидает и в каких сценариях следует применять конкретные функции. Если `llms.txt` отвечает на вопрос «что здесь есть?», то `skill.md` отвечает на вопрос «что я могу с этим сделать?». Совместное использование этих форматов позволяет создавать более предсказуемые и автономные агентные системы.

Ключевые факты

  • `llms.txt` предназначен для передачи контекста проекта, включая документацию, API-эндпоинты и правила разработки, в формате, оптимизированном для чтения LLM.
  • `skill.md` используется для формализации агентных навыков, определяя границы компетенций, входные данные и ожидаемые результаты для конкретных функций.
  • Использование обоих файлов позволяет снизить количество ошибок при вызове инструментов (tool calling) и улучшить навигацию агента по сложным кодовым базам.
  • Стандарты направлены на унификацию взаимодействия между разработчиками и ИИ-агентами, исключая необходимость каждый раз пересказывать структуру проекта в промпте.