NeuralDeep Skills — российский каталог скиллов

Skills — это модульные инструкции, которые расширяют возможности AI-агентов. Вместо того чтобы каждый раз объяснять агенту, как работать с 1С, Яндекс.Метрикой или Битрикс24, вы устанавливаете скилл — и агент знает, что делать. Формат SKILL.md стал открытым стандартом: один и тот же скилл работает в Claude Code, Cursor, Codex, Windsurf и других инструментах.

Проблема в том, что большинство каталогов скиллов — англоязычные. OpenClaw (5 400+ скиллов), Anthropic Skills, awesome-claude-skills — всё ориентировано на западный стек. Скилла для Яндекс.Вебмастера, DaData или 1С:Предприятие там не найти.

NeuralDeep Skills (skillsБД) закрывает эту нишу: российский каталог скиллов и MCP-серверов с CLI-установщиком, модерацией и фокусом на RU-инфраструктуру.

Что такое скиллы и зачем они нужны

Скилл — это папка с файлом SKILL.md, который содержит инструкции для AI-агента. Когда агент сталкивается с задачей, он проверяет установленные скиллы, находит подходящий и следует его инструкциям. Скилл не исполняет код сам по себе — он учит агента как выполнить задачу.

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

.claude/
└── skills/
    └── yandex-metrika/
        ├── SKILL.md           # Инструкции для агента (обязательно)
        ├── examples/
        │   └── sample-query.md # Примеры запросов
        └── scripts/
            └── auth.sh         # Вспомогательные скрипты

Файл SKILL.md состоит из двух частей:

1. YAML-фронтматтер — метаданные: название, описание, когда использовать
2. Markdown-контент — собственно инструкции, шаги, примеры

---
name: yandex-metrika
description: Работа с API Яндекс.Метрики — отчёты, цели, сегменты.
  Используй, когда пользователь просит аналитику или данные из Метрики.
---

## Подключение
Используй OAuth-токен из переменной окружения YANDEX_METRIKA_TOKEN.
Base URL: https://api-metrika.yandex.net/stat/v1/data

## Доступные отчёты
- Посещаемость: GET /stat/v1/data?metrics=ym:s:visits
- Источники трафика: dimensions=ym:s:trafficSource
...

Скилл vs CLAUDE.md vs MCP

NeuralDeep: российский каталог

NeuralDeep — это российский AI-хаб, созданный Валерой Ковальским. Помимо LLM-прокси, OpenAI-совместимого API и AI-агента Drift, NeuralDeep ведёт открытый каталог скиллов и MCP-серверов — skillsБД.

Что внутри skillsБД

Ключевые скиллы каталога

Установка и использование

CLI: npx skillsbd

Установщик skillsbd работает через npx — не нужно устанавливать глобально:

# Установить скилл
npx skillsbd add theYahia/dadata-mcp/dadata-skills

# Найти скиллы
npx skillsbd search "яндекс"

# Список установленных
npx skillsbd list

# Удалить скилл
npx skillsbd remove dadata-skills

После установки скилл появляется в .claude/skills/ и сразу доступен агенту.

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

Если CLI не подходит (например, корпоративные ограничения):

# 1. Клонируете репозиторий скилла
git clone https://github.com/theYahia/dadata-mcp.git /tmp/dadata

# 2. Копируете папку скилла
cp -r /tmp/dadata/dadata-skills .claude/skills/

# 3. Проверяете структуру
ls .claude/skills/dadata-skills/SKILL.md

Где хранить скиллы

Как написать собственный скилл

Создание скилла — это формулировка инструкции, которой агент будет следовать. Хороший скилл решает одну конкретную, повторяемую задачу.

Шаг 1: Структура

mkdir -p .claude/skills/my-skill
touch .claude/skills/my-skill/SKILL.md

Шаг 2: Фронтматтер

---
name: my-skill
description: |
  Краткое описание того, что делает скилл.
  Используй, когда пользователь просит X или Y.
allowed-tools: Read Grep Bash
---

Ключевые поля фронтматтера:

Шаг 3: Контент

Два типа контента определяют поведение скилла:

Референсный скилл — добавляет знания (конвенции, API, паттерны):

---
description: API-конвенции нашего проекта
---

При создании API-эндпоинтов:
- RESTful именование
- Единый формат ошибок: { error: string, code: number }
- Валидация через zod-схемы
- Логирование через pino

Задачный скилл — пошаговая инструкция для конкретного действия:

---
description: Деплой приложения на продакшен
disable-model-invocation: true
context: fork
---

## Шаги
1. Запусти тесты: `npm test`
2. Собери приложение: `npm run build`
3. Проверь, что build/ содержит index.html
4. Задеплой: `npx wrangler deploy`
5. Проверь статус: `curl -I https://site.ru`

Шаг 4: Тестирование

# Запустите Claude Code
claude

# Вариант 1: вызов напрямую
/my-skill

# Вариант 2: описание задачи (агент найдёт скилл сам)
"Задеплой приложение на продакшен"

Динамический контекст и продвинутые паттерны

Инъекция контекста

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

---
description: Анализ текущих изменений в коде
---

## Текущие изменения

[OBFUSCATED PROMPT INJECTION]

## Инструкции
Суммаризируй изменения в 3-5 пунктов.
Отметь риски: пропущенная обработка ошибок,
захардкоженные значения, непокрытые тесты.

Подстановка аргументов

---
description: Создание нового компонента
arguments: [name, type]
---

Создай компонент $name типа $type в src/components/.
Используй шаблон из examples/component-template.tsx.

Вызов: /create-component Button form

Вспомогательные файлы

Для сложных скиллов выносите детали в отдельные файлы:

my-skill/
├── SKILL.md              # Краткие инструкции + навигация
├── api-reference.md      # Полная документация API
├── examples.md           # Примеры использования
└── scripts/
    └── validate.sh       # Скрипт валидации

В SKILL.md ссылайтесь на файлы — агент загрузит их только когда понадобится:

## Дополнительно
- Полное API: [api-reference.md](api-reference.md)
- Примеры: [examples.md](examples.md)

NeuralDeep Skills vs другие каталоги

Контрибьютинг в каталог

NeuralDeep принимает скиллы от сообщества через форму с модерацией:

1. Авторизуйтесь на neuraldeep.ru через GitHub OAuth
2. Заполните форму — укажите репозиторий, описание, категорию
3. Модерация — команда проверяет качество и безопасность
4. Публикация — скилл появляется в каталоге и доступен через npx skillsbd add

Требования к скиллу

• Рабочий SKILL.md с корректным фронтматтером
• Описание на русском и/или английском
• Публичный GitHub-репозиторий
• README с инструкцией по установке и использованию
• Отсутствие хардкоженных токенов и секретов

Антипаттерны

Чеклист

Полезные ссылки

• NeuralDeep Skills: neuraldeep.ru/skills — каталог скиллов и MCP для RU-комьюнити
• NeuralDeep Telegram: t.me/neuraldeep — канал Валеры Ковальского про LLM и агентов
• Claude Code Skills: code.claude.com/docs/en/skills — официальная документация
• Anthropic Skills: github.com/anthropics/skills — демонстрационные скиллы от Anthropic
• Agent Skills Guide (PDF): resources.anthropic.com — полное руководство по созданию скиллов
• OpenClaw: clawskills.sh — крупнейший каталог (5 400+ скиллов)
• awesome-claude-skills: github.com/travisvn/awesome-claude-skills — курированный список
• 1С Skills: github.com/Nikolay-Shirokov/cc-1c-skills — 65 скиллов для 1С:Предприятие

По теме

• База знаний: Skills и Plugins в Codex App: установка, использование и создание своих
• Статья: Как Codex стал моим техническим партнёром, а не просто чатиком для кода
• Блог: Notion — одна из немногих SaaS, которые реально переизобрели себя под ИИ

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov