Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
Вклад в Skill (Русский)
English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية
Skill — это папка внутри skills/ с файлом SKILL.md в корне, следующая соглашению SKILL.md. Она упаковывает переиспользуемый рабочий процесс агента: когда его использовать, какие команды или инструменты вызывать и как интерпретировать результаты. Это руководство объясняет, как добавить Skill.
Что Skill ЕСТЬ / чем НЕ является
Skill ЕСТЬ:
- Повторяемый рабочий процесс, которому может следовать агент, описанный на естественном языке плюс команды.
- Предметные знания, которым не место в основном коде: как вызвать этап CLI, как структурировать промпт для медиапровайдера, как валидировать план.
- Небольшой объём. Одна папка, один
SKILL.md, необязательнаяreferences/для длинных материалов, которые агент читает по требованию.
Skill НЕ является:
- Продуктовой функцией. Изменения UI, новые эндпоинты Runtime и новое поведение рабочего пространства — это вклад в код (
apps/web/,apps/daemon/). - Копией существующего Skill с немного изменённой формулировкой. Если ваше изменение улучшает существующий процесс, отредактируйте тот Skill напрямую.
- Обёрткой вокруг учётных данных или локальных путей конкретного пользователя. Skill должен работать из чистого чекаута.
Быстрый старт
git clone https://github.com/krillinai/OpenCreator.git
cd OpenCreator
corepack enable && pnpm install
cp -r skills/krillinai-tts skills/<ваш-skill> # начните с ближайшего существующего Skill
# отредактируйте skills/<ваш-skill>/SKILL.md
pnpm web:dev # проверьте, что агент распознаёт его в диалоге
Самый быстрый путь — скопировать Skill, наиболее близкий к вашей идее, и переписать его: существующие Skill krillinai-* показывают ожидаемую структуру и тон.
Анатомия Skill
skills/<ваш-skill>/
├── SKILL.md # обязательно: frontmatter + инструкции
└── references/ # необязательно: длинные документы, на которые ссылается SKILL.md
└── cli-contract.md
SKILL.md начинается с YAML frontmatter:
---
name: ваш-skill
description: Use when <условие срабатывания>, including <основные возможности>.
---
Два правила, которые применяют ревьюеры:
nameдолжен совпадать с именем папки. Строчные буквы, через дефис.description— это поверхность обнаружения. Именно её агент читает, чтобы решить, применим ли этот Skill. Пишите в формате "Use when …", называйте триггер и результат, уложитесь в одно-два предложения. Расплывчатые описания («помогает с видео») возвращаются на доработку.
Тело должно охватывать, по порядку:
- Когда использовать — один абзац.
- Команды — блоки кода с точным вызовом, включая необходимые переменные окружения или рабочие каталоги.
- Входы и флаги — таблица для всего неочевидного; отметьте обязательное и необязательное.
- Выходы — куда попадают результаты и как их читать (например, «читайте пути из манифеста»).
- Режимы отказа — известные ошибки и что с ними делать.
Держите SKILL.md удобным для беглого просмотра. Длинные контракты, полные списки флагов или справочные материалы выносите в references/ и ссылайтесь относительными путями — агент читает references только при необходимости.
Локальная проверка
После pnpm web:dev начните диалог и опишите задачу, которая должна активировать ваш Skill. Проверьте:
- Агент выбирает Skill для правильных запросов — и не выбирает для несвязанных.
- Команды Skill выполняются из чистого чекаута без ручных правок.
- Пути вывода и обработка ошибок соответствуют документации.
Критерии слияния
Ревьюер проверит каждый пункт — вставьте список в PR и отметьте:
- Имя папки и frontmatter
nameсовпадают; строчные буквы через дефис. -
descriptionназывает условие срабатывания и результат ("Use when …"). - Команды работают из чистого чекаута; без абсолютных локальных путей и учётных данных.
- Входы, выходы и режимы отказа задокументированы.
- Длинные справочные материалы находятся в
references/, а не в основном тексте. - Проверено в реальном диалоге: Skill срабатывает, когда должен, и только тогда.
- Если Skill пересекается с существующим, PR объясняет, почему нужен отдельный.
Частые причины отклонения
- Дубликат существующего Skill с косметическими правками формулировок — вместо этого улучшите существующий.
- Замаскированная функция — Skill работает только вместе с изменениями кода Runtime или UI; отправьте изменение кода отдельным PR.
- Непроверенные команды — несуществующие флаги или выходы, не совпадающие с задокументированными путями.
- Незадокументированные предпосылки — Skill молча предполагает конфигурацию провайдера, бинарный файл или сетевой сервис.
Вопросы? Откройте issue с темой skill — мы поможем определить рамки.