# using-n8n-mcp-skills

Скилл-маршрутизатор для работы с n8n через MCP-сервер n8n-mcp: разводит задачи по профильным скиллам пакета и задаёт правила, без которых воркфлоу ломается в проде.

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

## Что делает

Скилл работает как маршрутизатор: своих правил почти не держит, зато разводит задачу по профильным скиллам пакета n8n-mcp-skills и требует подгружать их до первого действия. Правка узла, выражение внутри `{{ }}`, Code-узел, схема воркфлоу — на всё найдётся свой скилл. Дальше три требования без исключений. Скилл вызывается раньше любых операций с n8n. Перед активацией идёт `validate_workflow`, а после create или update нужен `n8n_get_workflow` с ручной проверкой объекта `connections`. Токены и пароли живут только в системе креденшелов n8n.

Зачем столько дисциплины? n8n и n8n-mcp меняются быстрее, чем обновляется обучение модели. Имена параметров и `typeVersion` узлов расходятся между релизами, поэтому скилл велит верить живому инструменту: если `get_node` показывает другое, прав он, а не память агента. Заодно предупреждает, что валидация проходит и на воркфлоу с неподключёнными ветками, а JS-ошибка внутри выражения тихо превращается в `null`. Зелёный прогон ничего не доказывает, пока не посмотришь выходные значения.

Работает это вместе с MCP-сервером n8n-mcp. Хуки `PreToolUse`, которые напоминают о правилах, есть только в установке плагина для Claude Code. В Cursor, Codex, Copilot, Gemini CLI и OpenCode подсказок не будет, так что дисциплина целиком на вас.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install czlonkowski/n8n-skills using-n8n-mcp-skills
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -a opencode
```

### Claude.ai

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

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

## Когда брать
- собрать воркфлоу из узлов, не сверяясь с памятью модели
- проверить `connections` сразу после создания или обновления воркфлоу
- убрать токен из Set-узла в креденшелы n8n
- найти профильный скилл под конкретную задачу: выражение, Code-узел, отладка
- отличить прошедшую валидацию от рабочего воркфлоу

## Примеры запросов агенту
- Собери воркфлоу n8n: вебхук принимает заявку, дальше фильтр и запись в таблицу
- В Merge теряется третий источник, разберись
- Проверь воркфлоу перед активацией: `connections` и выходные значения

## Похожие
- [using-n8n-skills-official](https://affpapa.org/nevibecode/skills/using-n8n-skills-official.md) — скилл · 2000 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/workflow-automation.md) — скилл · 1661 установка
- [n8n-workflow](https://affpapa.org/nevibecode/skills/n8n-workflow.md) — скилл · 4800 установок
- [n8n-workflow-lifecycle-official](https://affpapa.org/nevibecode/skills/n8n-workflow-lifecycle-official.md) — скилл · 2400 установок
- [ai-agent-builder](https://affpapa.org/nevibecode/skills/ai-agent-builder.md) — скилл · 4800 установок
- [agent-orchestration](https://affpapa.org/nevibecode/skills/agent-orchestration.md) — скилл · 1400 установок

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

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