SkillFoxx
Telegram

Dify Workflow DSL Skill

Скилл создает, чинит и проверяет YAML-схемы приложений Dify 1.18 с профилями 1.15 и 1.16, чтобы импорт проходил без ручной правки.

  • 106 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Установщик копирует файлы в каталог навыков, а валидатор создает виртуальное окружение и ставит пакеты Python.
Все причины и проверки

yzmw123/dify-workflow-dsl-skillАвтор:yzmw123

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/dify-workflow-dsl-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Установщик копирует файлы в каталог навыков, а валидатор создает виртуальное окружение и ставит пакеты Python.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл учит агента писать импортируемые файлы Dify App DSL: Workflow, Chatflow, Agent App и узлы Agent v2. Агент выбирает версию (по умолчанию Dify 1.18 и DSL 0.7.0, для Dify 1.15 нужен DSL 0.6.0), строит граф узлов, соединяет ребра и добавляет зависимости плагинов. Затем он запускает `scripts/run_validator.py --strict --dify-version <версия>`: валидатор сам создает виртуальное окружение и выдает ошибки со стабильными кодами и JSON. В репозитории лежат 14 проверенных примеров. В готовых файлах скилл чинит ветки, селекторы и устаревшие структуры.

Для кого. Разработчикам приложений и рабочих процессов Dify, которым агент должен выдавать файлы, импортируемые без ручной правки.

Подходит, если

  • Новый workflow Dify с ветвлением, циклом и узлом человеческого подтверждения собирают по описанию задачи.
  • Файл после экспорта из Dify 1.16 переносят на 1.18.
  • Импорт падает с ошибкой версии DSL, и причину не видно.
  • Перед выкладкой в CI прогоняют `run_validator.py --strict` по папке с YAML.

Не подходит, если

  • Нужно проверить выполнение модели и результат узлов: валидатор статический.
  • Приложение правят прямо в интерфейсе Dify без экспорта YAML.
  • Рабочее пространство старше Dify 1.15: профили для него не описаны.

Пример запроса к агенту

Используй $dify-workflow-dsl: создай workflow для Dify 1.15.0 на DSL 0.6.0, который суммирует текст, и проверь его валидатором.

Ограничения

Проверка статическая: версии установленных плагинов, схемы инструментов, базы знаний и секреты остаются на стороне вашего рабочего пространства и после импорта привязываются заново. Выполнение модели и повторный экспорт из интерфейса проверяют уже в самом Dify. Валидатору нужен Python 3.10 или новее, при первом запуске он ставит PyYAML в кеш-окружение, а для офлайна нужны локальные колеса. Файла лицензии в репозитории нет, это стоит учесть при использовании в проектах компании.

Как отключить. Удалите установленную папку скилла из каталога навыков вашего агента и клон репозитория.

Частые вопросы

Какую версию Dify скилл берет по умолчанию?

Dify 1.18 с DSL `0.7.0`. Для Dify 1.15 нужен DSL `0.6.0`, версию задают флагом `--dify-version`.

Для каких агентов есть установка?

`install.sh` принимает платформы claude, codex, openclaw, hermes, opencode и all. Свой каталог навыков задает `--target-dir`.

Когда выбирать advanced-chat?

Когда нужны память диалога, `sys.query`, загрузка файлов в чат или узлы `answer`. Для остальных задач по умолчанию подходит `workflow`.

Какие узлы покрывает скилл?

Start, End, Answer, LLM, Code, IF/ELSE, классификатор вопросов, Human Input, Iteration, Loop, Assigner v2, инструменты, триггеры и поиск по знаниям.

Как проверить файл перед импортом?

Запустите `python3 scripts/run_validator.py --strict --dify-version 1.18 workflow.yml`. Валидатор печатает ошибки со стабильными кодами, а JSON-вывод подходит для CI.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл, который помогает агенту писать другие скиллы по спецификации agentskills.io: структура, метаданные, прогрессивная подача и проверка

СкиллМинимальный доступ2,3 тыс.

Скилл для создания скиллов, который проверяет их работой: замер до и после, регрессионные тесты и аудит экосистемы

СкиллРасширенный доступ918

Метаскилл превращает разрозненные правила в AGENTS.md, CLAUDE.md и Cursor в один проверяемый скилл проекта с маршрутами задач.

ПлагинРасширенный доступ622

Скилл для создания, проверки и улучшения других скиллов: сначала архитектура, потом тесты, оценка и упаковка

СкиллРасширенный доступ212

CLI-менеджер скиллов для ИИ-агентов: установка из репозиториев, перевод между форматами разных агентов и раскладка в их конфигурацию

CLIРасширенный доступ1,6 тыс.

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

СкиллМинимальный доступ102

Коротко о README

В README скилл представлен как средство для создания, ремонта, ревью и миграции DSL приложений Dify. Версия 2026-10-30 добавила профили Dify 1.18 и актуальные схемы Agent и базы знаний. Проверку подкрепляют 54 регрессионных теста, а все 14 примеров прошли импорт в реальную базу Dify.

Бейдж для README

Исходный SKILL.md

---
name: dify-workflow-dsl
description: >
  Create, modify, review, migrate, and debug import-ready Dify App DSL YAML for
  Dify 1.18 and legacy 1.15/1.16 targets (DSL 0.6.0 and 0.7.0). Use for
  Workflow, Chatflow, Agent App, Agent v2 workflow
  nodes, Human Input, graph wiring, variables, plugin dependencies, tools,
  database operations, and import/export compatibility.
---

# Dify Workflow DSL

Produce import-ready Dify App DSL YAML. Treat official Dify source as schema
authority and exported files from the target workspace as authority for dynamic
plugin/tool fields.

## Core Workflow

1. Identify the target Dify/DSL version before authoring. For a new file, default
   to Dify `1.18` with DSL `0.7.0`. Use `1.16` / `0.7.0` or `1.15` / `0.6.0`
   for older workspaces. The DSL version alone does not distinguish 1.16 from 1.18.
   Preserve an existing supported version unless the user asks to migrate it.
   Always quote `version`.
2. Choose the app mode:
   - `workflow` for one-shot, batch, triggered, integration, and structured-output
     automations.
   - `advanced-chat` for multi-turn chat, memory, `sys.query`, `sys.files`, and
     `answer` nodes.
   - `agent` only for a top-level portable Agent App in DSL `0.7.0`.
3. Clarify only import-blocking facts: inputs, outputs, model/provider, installed
   plugins, knowledge bases, secrets, trigger source, or required Agent package.
4. Sketch the graph or Agent package before writing YAML. A graph needs an entry,
   connected processing nodes, and a reachable `end`/`answer` unless a triggered
   side-effect workflow intentionally returns nothing.
5. Add a top-level dependency for every referenced marketplace/package/GitHub
   plugin. Preserve exact exported identifiers.
6. Write stable string IDs and connect edges with existing endpoints, matching
   `sourceType`/`targetType`, and valid branch `sourceHandle` values.
7. Run `python3 scripts/run_validator.py --strict --dify-version <1.15|1.16|1.18> <file.yml>`.
   The runner creates a cached virtual environment and installs `requirements.txt`
   on first use. Python 3.10+ is required; see `references/runtime.md` for offline setup.
   Fix all errors and warnings unless a warning is an intentional, documented
   behavior risk.
8. When a matching Dify source environment is available, run
   `scripts/validate_with_dify_source.py` before claiming source compatibility.

Сообщить о проблеме