# n8n-subworkflows-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-subworkflows-official/SKILL.md
- Обновлён: 2026-10-17
- HTML: https://affpapa.org/nevibecode/skills/n8n-subworkflows-official

## Что делает

Сабворкфлоу в n8n — это функции: `Execute Workflow Trigger` объявляет входные параметры, тело делает работу, последний узел возвращает результат. Вызывающий воркфлоу обращается к нему как к обычному узлу. Скилл подсказывает агенту, когда такую функцию стоит выделить, а когда оставить логику на канвасе.

Перед сборкой новой логики скилл велит искать готовое: `search_workflows({ tags: ['subworkflow'] })` или поиск по ключевому слову. Теги — механизм обнаружения, они появились в n8n 2.27.0. Каждый сабворкфлоу получает тег `subworkflow`, доменный тег вроде `customer` или `tool`, а имя остаётся простым и описательным: `Parse RFC2822 date`.

Внутри есть дерево решений и разбор stateless против stateful. Чистая логика по умолчанию без состояния; работа с внешним хранилищем строится намеренно, за аккуратным контрактом, как репозиторий в ORM. Случайные побочные эффекты — отдельная головная боль: сабворкфлоу, который выглядит чистым, но тихо пишет в лог, подставит вызывающего, который считал повторный запуск безопасным. Триггер `Execute Workflow Trigger` работает в режиме Define Below с типизированными полями — исключения только для бинарных входов и для сабворкфлоу вообще без параметров.

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

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- Собери сабворкфлоу Parse RFC2822 date с тегом subworkflow, вход — строка даты, выход — ISO или ошибка
- Проверь через search_workflows, нет ли уже сабворкфлоу для получения клиента по id
- Этот кусок логики понадобится в другом воркфлоу — вынеси его в сабворкфлоу с типизированными полями

## Похожие
- [n8n-subworkflows](https://affpapa.org/nevibecode/skills/n8n-subworkflows.md) — скилл · 1900 установок
- [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 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/workflow-automation.md) — скилл · 1661 установка
- [airtable-automation](https://affpapa.org/nevibecode/skills/airtable-automation.md) — скилл · 6200 установок
- [teable-assistant-ops](https://affpapa.org/nevibecode/skills/teable-assistant-ops.md) — скилл · 488 установок

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

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