Для официальных Convex Skills используйте Convex Agent Plugins

Официальные Convex-плагины для AI-агентов разработки — инструменты для построения реактивных бэкендов на TypeScript.

https://github.com/get-convex/convex-agent-plugins

Convex (неофициальные) Skills

Коллекция AI-скиллов для построения production-ready приложений с Convex в соответствии с открытым форматом Agent Skills.

Обзор

Репозиторий содержит скиллы, помогающие AI-ассистентам понимать и применять лучшие практики Convex. Каждый скилл предоставляет структурированные рекомендации по конкретным аспектам разработки на Convex.

Качество кода

Все скиллы по умолчанию генерируют код, проходящий проверку @convex-dev/eslint-plugin. Это создаёт взаимодополняющий рабочий процесс:

• Скиллы предотвращают ошибки на этапе генерации
• ESLint перехватывает всё, что проскользнуло, на этапе сборки

Инструкции по настройке — в разделе «Качество кода» файла convex-best-practices.

Установка

npm (рекомендуется)

# Глобальная установка для доступа через CLI
npm install -g @waynesutton/convex-skills

# Список доступных скиллов
convex-skills list

# Установка конкретного скилла в проект
convex-skills install convex-best-practices

# Установка всех скиллов
convex-skills install-all

# Установка всех скиллов в .agents/skills
convex-skills install-all --target agents

# Создание симлинков на файлы SKILL.md вместо копирования
convex-skills install-all --target agents --link

# Установка шаблонов (CLAUDE.md + шаблоны скиллов)
convex-skills install-templates

Или используйте npx без установки:

npx @waynesutton/convex-skills list
npx @waynesutton/convex-skills install-all

Программное использование

import { listSkills, getSkill, SKILLS } from "@waynesutton/convex-skills";

// Список всех скиллов
console.log(listSkills());

// Получение содержимого конкретного скилла
const content = getSkill("convex-best-practices");

Claude Code (из локального клона)

git clone https://github.com/waynesutton/convexskills.git
cd convexskills
# Укажите Claude Code на эту директорию

Codex

Следуйте руководству по скиллам Codex и разместите скилл в $CODEX_HOME/skills:

# Из корня репозитория
# По умолчанию используется ~/.codex, если CODEX_HOME не задан
cp -r skills/convex-best-practices "$CODEX_HOME/skills/"

Codex автоматически обнаружит файлы SKILL.md в этой директории при следующем запуске.

При работе из клона репозитория Codex также автоматически обнаруживает скиллы из .codex/skills в корне репозитория. Можно создать симлинки из skills/* этого репозитория в .codex/skills, чтобы обновления применялись без копирования.

Стандартный путь Agent Skills

Некоторые инструменты стандартизируют путь .agents/skills для обнаружения скиллов. Репозиторий поддерживает эту структуру через CLI:

convex-skills install-all --target agents
convex-skills install-all --target agents --link

OpenCode

OpenCode автоматически обнаруживает скиллы по пути ~/.claude/skills/<name>/SKILL.md. Подробнее — в документации OpenCode Skills.

Slash-команда

Репозиторий включает slash-команду /convex для OpenCode. Установите команду, скопировав command/convex.md в директорию команд OpenCode:

# Копирование slash-команды
cp command/convex.md ~/.opencode/command/

# Использование в OpenCode
/convex create a schema with users and posts
/convex set up file uploads
/convex add a Stripe webhook endpoint

Slash-команда предоставляет деревья решений для маршрутизации к нужному скиллу в зависимости от задачи.

Ручная установка

Скопируйте файл SKILL.md нужного скилла в директорию .claude/skills/ вашего проекта.

Доступные скиллы

Структура репозитория