AI Skills (ИИ Навыки)

В этом репозитории помимо документов есть папка ai-skills - это ИИ читаемые инструкции и best-practices, призванные дать ИИ структурированные данные о том, как и что делается в проекте, системе и в компании в целом. Таким образом ИИ получает более богатый контекст без написания огромных промтов, описывающих все аспекты системы.

Как это работает

В проекте нужно создать в корне папку .agents/skills внутри этой папки будут лежать отдельные навыки, каждый в своей подпапке (kebab-case)

Каждый навык у себя в корне содержит файл SKILL.md, который кратко описывает суть, и папку references в которой в виде отдельных файлов лежат детали по каждому аспекту. В корневом файле они упоминаются как ссылки по теме в тексте. Таким образом ИИ быстро загружает в контекст сам SKILL.md (он должен быть небольшой) и пользуется ссылками для получения подробностей.

Для Cursor нужно добавить папку .cursor, в которой может быть symlink на .agents/skills, тогда навыки будут доступны в чате курсора. Для Claude навыки будут доступны без дополнительных настроек из папки agents.

Как пользоваться

В SKILL.md есть заголовок по которому сеть может понять в каком случае данный навык применим и автоматически подтягивает информацию из него. Можно явно в чате указывать /skill-name (слэш команда) для использования навыка в контексте запроса.

Пример

На основе документа от devops об обязательных требованиях к релизу нового проекта сделали скилл ventrago-service-prepare можно установить его в домашнюю папку и запускать для любого проекта, ИИ создаст отчет о необходимых доработках для соответствия требованиям команды DevOps для запуска в продакшен.

Ссылки и материалы

• Claude Code — Slash Commands (Skills)Custom slash commands — документация по созданию пользовательских slash-команд в Claude Code: структура .claude/commands/, Markdown-файлы как инструкции, передача аргументов через $ARGUMENTS.

• Cursor Community Forum — Agent Skills
  How to use Agent Skills in Cursor IDE — обсуждение и вопросы по навыкам агента в Cursor.

• Cursor Integration Guide (Agent Skills)
  agentskills.help — Cursor — руководство по установке и использованию навыков в Cursor (в т.ч. через CLI и настройки).

• Skill.shSkills.sh — каталог и примеры Agent Skills (как создавать навыки, готовые навыки по темам).

• SkillMD.ai
  SkillMD.ai — еще каталог навыков с акцентом на Cursor.

• Встроенный навык Cursor «create-skill»
  Файл ~/.cursor/skills-cursor/create-skill/SKILL.md — официальная инструкция Cursor по созданию навыков: структура SKILL.md, YAML frontmatter, progressive disclosure, антипаттерны и чеклист. Полезно перечитать перед созданием нового навыка.

• Правила Cursor (Rules) Навыки (Skills) дополняют Cursor Rules — правила задают общий стиль и контекст проекта; навыки — пошаговые инструкции под конкретные задачи.

• Claude Code — CLAUDE.md (Memory)CLAUDE.md — файлы памяти Claude Code: как задавать контекст проекта, стиль кода и правила на уровне репозитория, папки или пользователя (аналог Cursor Rules).