Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

AI-ассистенты и SKILL

Добавьте навык iEXExchanger в Claude, Codex, Cursor, VS Code или другой AI-ассистент для работы с документацией продукта.

SKILL.md позволяет добавить в AI-ассистент постоянные правила работы с документацией iEXExchanger.

После установки навыка ассистент сможет:

  • искать инструкции по iEXExchanger;

  • открывать полное содержимое найденных страниц;

  • сохранять точные названия разделов, полей и параметров;

  • учитывать версию продукта и используемое окружение;

  • подготавливать инструкции с проверкой результата;

  • прикладывать ссылки на использованные страницы;

  • сообщать, если в документации нет подтверждённого ответа.

SKILL.md не содержит всю документацию внутри себя. Он объясняет ассистенту, где искать информацию, как проверять источники и какие правила соблюдать при подготовке ответа.

Навык предназначен для работы с документацией. Он не предоставляет доступ к административной панели, серверу, базе данных, заявкам или другим данным обменного пункта.

Как работает навык

Для полноценной работы используются три компонента:

Компонент
Назначение
Обновление

SKILL.md

Задаёт правила поиска, ответа и безопасности

Скопированную версию нужно обновлять вручную

MCP документации

Позволяет искать и открывать опубликованные страницы

Использует актуальное содержимое при каждом запросе

llms.txt и Markdown

Используются, если клиент не поддерживает MCP

Загруженные копии нужно периодически заменять

Рекомендуемый вариант — установить SKILL.md и подключить MCP документации. В этом случае навык определяет порядок работы, а MCP предоставляет актуальное содержимое страниц.

Один файл SKILL.md не загружает документацию автоматически. Ассистенту также нужен MCP, доступ к страницам документации через интернет или заранее загруженные файлы.

Готовый SKILL.md

Создайте папку iexexchanger-docs, добавьте в неё файл SKILL.md и скопируйте следующее содержимое.

Название папки должно совпадать со значением name:

Итоговая структура:

Не добавляйте в SKILL.md пароли, токены, приватные адреса или другие секретные данные.

Установка навыка

Выберите клиент, в котором будет использоваться навык.

Для использования навыка только в одном проекте сохраните файл по пути:

Для использования во всех проектах текущего пользователя:

После добавления файла откройте Claude Code и явно запустите навык:

Claude Code также может применить навык автоматически, когда запрос соответствует его описанию.

Если каталог .claude/skills был создан после запуска текущей сессии и навык не появился, перезапустите Claude Code.

Подробнее: навыки Claude Code.

Для использования навыка в одном проекте сохраните файл по пути:

Для использования во всех проектах текущего пользователя:

Откройте Codex и выполните:

Убедитесь, что iexexchanger-docs появился в списке.

Для явного применения навыка укажите его в запросе:

Codex также может выбрать навык автоматически, когда задача соответствует полю description.

Изменения в навыках обычно обнаруживаются автоматически. Если новый файл не появился, перезапустите Codex.

Подробнее: навыки Codex.

Для использования в текущем проекте сохраните файл по пути:

Для использования во всех проектах текущего пользователя:

Для переносимого навыка, который будет использоваться несколькими совместимыми клиентами, можно применить путь:

Не создавайте несколько одинаковых копий навыка одновременно.

После добавления файла:

  1. Откройте настройки Cursor.

  2. Перейдите в раздел Skills.

  3. Найдите iexexchanger-docs.

  4. Откройте новый Agent Chat.

  5. Выполните /iexexchanger-docs.

Cursor также может применить навык автоматически, если запрос соответствует его описанию.

Подробнее: навыки Cursor.

Для текущего проекта рекомендуется использовать путь:

Также VS Code поддерживает проектный путь:

Для использования во всех проектах текущего пользователя:

Также поддерживается пользовательский путь:

Выберите один путь и не создавайте несколько одинаковых копий.

После добавления файла:

  1. Откройте Chat.

  2. Введите /skills.

  3. Откройте список доступных навыков.

  4. Найдите iexexchanger-docs.

  5. Начните новый диалог.

Для явного запуска выберите навык из списка команд или введите его название после /.

Подробнее: Agent Skills в VS Code.

Если клиент поддерживает стандарт Agent Skills, сохраните папку iexexchanger-docs в каталоге навыков, указанном в его документации.

Структура должна выглядеть так:

Если клиент не поддерживает навыки:

  1. Прикрепите SKILL.md к проекту или диалогу.

  2. Добавьте его содержимое в постоянные инструкции.

  3. Укажите, что правила относятся ко всем вопросам по iEXExchanger.

  4. Подключите MCP или предоставьте нужные страницы документации.

Наличие файла с именем SKILL.md само по себе не означает, что клиент его использует. Клиент должен поддерживать навыки или получить прямое указание прочитать файл.

Подключение документации

После установки навыка подключите MCP документации iEXExchanger.

Используйте следующий адрес:

Через MCP ассистент сможет:

  • искать страницы;

  • открывать полное содержимое найденных материалов;

  • получать актуальную опубликованную версию;

  • прикладывать ссылки на источники.

Если MCP не поддерживается, используйте индекс:

Для загрузки полного содержимого доступны:

Не загружайте все части без необходимости. Для одного вопроса обычно достаточно llms.txt и нескольких связанных Markdown-страниц.

Проверка навыка

После установки начните новый диалог и отправьте следующий запрос:

file-codeПроверка навыка iEXExchanger

Навык работает корректно, если ассистент:

  • обратился к документации iEXExchanger;

  • прочитал полную страницу;

  • сохранил точные названия элементов интерфейса;

  • не добавил неподтверждённые параметры;

  • объяснил способ проверки;

  • приложил прямые ссылки на источники;

  • сообщил о недостатке информации, если точного ответа нет.

Примеры запросов

Найти настройку
list-checkПодготовить инструкцию
Найти причину проблемы
shield-checkПроверить инструкцию

Обновление навыка

Скопированный SKILL.md не обновляется автоматически.

После публикации новой версии навыка:

  1. Замените старый файл SKILL.md.

  2. Проверьте, что имя папки осталось iexexchanger-docs.

  3. Удалите лишние копии навыка.

  4. Начните новый диалог.

  5. Повторите проверочный запрос.

Документация, которую ассистент получает через MCP, обновляется отдельно и не хранится внутри SKILL.md.

Безопасность

Не передавайте AI-ассистенту реальные:

  • пароли;

  • seed-фразы;

  • приватные ключи;

  • SSH-ключи;

  • API-токены;

  • данные мерчантов;

  • пароли базы данных;

  • данные SMTP;

  • платёжные реквизиты;

  • документы клиентов;

  • персональные данные;

  • данные реальных заявок;

  • рабочий файл .env.

Проверяйте прикреплённые файлы, снимки экрана, журналы и вывод терминала. Они также могут содержать секретные значения.

Не разрешайте ассистенту автоматически удалять файлы, восстанавливать базу данных, изменять SSH, Firewall или рабочую конфигурацию сервера без проверки человеком, понимания последствий и актуальной резервной копии.

Решение проблем

Навык не появился в клиенте

Симптом: iexexchanger-docs отсутствует в списке навыков.

Что проверить:

  • файл называется точно SKILL.md;

  • файл находится внутри папки iexexchanger-docs;

  • выбран правильный каталог для используемого клиента;

  • во frontmatter указаны name и description;

  • значение name совпадает с названием папки;

  • файл сохранён в формате Markdown;

  • нет второй копии навыка с тем же именем.

Для Codex итоговый путь должен выглядеть так:

Для Claude Code:

Для Cursor:

После проверки начните новую сессию или перезапустите клиент.

Проверка результата: iexexchanger-docs должен появиться в списке доступных навыков.

Навык установлен, но не применяется автоматически

Симптом: ассистент отвечает без поиска в документации.

Причина: запрос не совпал с описанием навыка или клиент выбрал другой источник.

Как исправить: запустите навык явно.

Для Claude Code и Cursor:

Для Codex:

Затем повторите вопрос.

Проверка результата: ассистент должен обратиться к документации и приложить ссылки на использованные страницы.

Ассистент отвечает общими словами

Симптом: ответ не содержит точных названий, действий и ссылок.

Что проверить:

  • навык действительно загружен;

  • MCP подключён;

  • клиент имеет доступ к интернету;

  • страницы были полностью открыты;

  • запрос содержит конкретную задачу;

  • ассистенту передана версия iEXExchanger и окружение, если они влияют на ответ.

Явно укажите:

Проверка результата: ответ должен содержать подтверждённую инструкцию и прямые ссылки.

MCP недоступен

Симптом: ассистент не может использовать searchDocumentation или getPage.

Причина: MCP-сервер не подключён, отключён или не поддерживается клиентом.

Как исправить: подключите MCP по инструкции «MCP документации iEXExchanger».

Если клиент не поддерживает MCP, передайте ему:

Затем добавьте Markdown-страницы, относящиеся к задаче.

Проверка результата: ассистент должен открыть страницы документации и сослаться на них в ответе.

Используется устаревшая копия навыка

Симптом: ассистент применяет старые источники или правила.

Причина: в проекте или пользовательском каталоге осталась предыдущая версия SKILL.md.

Что проверить:

  • проектный каталог навыков;

  • пользовательский каталог навыков;

  • другие совместимые каталоги;

  • одинаковые навыки с именем iexexchanger-docs.

Удалите лишние копии и оставьте только актуальную версию.

После замены файла начните новый диалог.

Проверка результата: проверочный запрос должен выполняться по новым правилам и актуальным источникам.

ПредыдущаяMCPСледующаяОптимизация работы с AI

Последнее обновление

Это было полезно?