# n8n-node-configuration-official

Помогает агенту собирать конфиги нод n8n по реальной схеме параметров, а не по памяти. Пригодится, когда воркфлоу ломается на валидации.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1900 установок · ★ 554
- Автор: n8n-io
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/n8n-io/skills/tree/HEAD/skills/n8n-node-configuration-official/SKILL.md
- Обновлён: 2026-10-17
- HTML: https://affpapa.org/nevibecode/skills/n8n-node-configuration-official

## Что делает

Скилл задаёт порядок работы с любой нодой n8n: сначала агент ищет подходящую ноду, выбирает пару `resource` и `operation`, потом запрашивает точную форму параметров через `get_node_types` с дискриминаторами. Без дискриминаторов возвращается общая схема, и часть обязательных полей просто не видна — отсюда ошибки вида «Cannot read property X».

Отдельное правило касается resource-locator и load-options параметров: каналы Slack, вкладки таблиц, таблицы и колонки в базе, списки моделей. Их значения скилл велит получать через `explore_node_resources` с `credentialId` из `list_credentials`, а не придумывать. Выдуманный ID проходит валидацию, но никуда не ведёт. Исключение — `toolWorkflow.workflowId`: его берут через `search_workflows` с `mode: 'id'`.

Внутри есть справочники по категориям нод: HTTP, вебхуки, базы данных, мессенджеры, AI, триггеры, Switch, Merge. Они описывают подводные камни и правила безопасности, а не имена полей. Если пример из справочника расходится с выводом `get_node_types`, скилл советует верить инструменту. Для отладки одной ноды есть `validate_node_config`, но публикацию всё равно закрывает `validate_workflow`.

## Требования
- Работает с: n8n, Slack, Gmail

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add n8n-io/skills --skill n8n-node-configuration-official -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/n8n-node-configuration-official/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/n8n-node-configuration-official/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add n8n-io/skills --skill n8n-node-configuration-official -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/n8n-node-configuration-official/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add n8n-io/skills --skill n8n-node-configuration-official -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/n8n-node-configuration-official/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install n8n-io/skills n8n-node-configuration-official
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/n8n-node-configuration-official/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add n8n-io/skills --skill n8n-node-configuration-official -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/n8n-io/skills --path skills/n8n-node-configuration-official
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/n8n-node-configuration-official/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add n8n-io/skills --skill n8n-node-configuration-official -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/n8n-io/skills/tree/HEAD/skills/n8n-node-configuration-official/SKILL.md

## Когда брать
- собрать конфиг ноды по актуальной схеме, а не по памяти
- найти обязательные поля, скрытые за условными зависимостями
- подставить настоящий ID канала Slack или вкладки таблицы
- проверить одну ноду, не прогоняя весь воркфлоу
- разобраться, почему параметры прошлой операции ломают валидацию

## Примеры запросов агенту
- Настрой HTTP Request ноду с авторизацией и пагинацией, сначала запроси точную схему параметров
- Добавь Slack-ноду на отправку сообщения в канал — резолвни реальный ID канала через explore_node_resources
- Проверь конфиг этой ноды через validate_node_config, потом прогони validate_workflow

## Похожие
- [n8n-workflow](https://affpapa.org/nevibecode/skills/n8n-workflow.md) — скилл · 4800 установок
- [n8n-workflow-patterns](https://affpapa.org/nevibecode/skills/czlonkowski-n8n-workflow-patterns.md) — скилл · 11700 установок
- [n8n-code-javascript](https://affpapa.org/nevibecode/skills/n8n-code-javascript.md) — скилл · 7200 установок
- [gmail-workflows](https://affpapa.org/nevibecode/skills/gmail-workflows.md) — скилл · 5000 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/workflow-automation.md) — скилл · 1661 установка
- [business-pulse](https://affpapa.org/nevibecode/skills/business-pulse.md) — скилл · 1800 установок

Из того же набора: [n8n-io/skills](https://affpapa.org/nevibecode/by/n8n-io/skills.md) — 14 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md