A Claude Code skill for writing production-ready Dify workflow DSL files.

This skill teaches Claude Code how to create, modify, and debug Dify workflow DSL (YAML) files. It covers variable syntax, node configuration, common pitfalls, and workflow patterns.

# Copy to your Claude skills directory
cp -r skills/dify-workflow-writer ~/.claude/skills/

Keep in your project's skills/ directory for project-specific usage.

• Variable Syntax Expert: Correct {{#NODE_ID.VAR#}} patterns
• Node Configuration: Templates for all Dify node types
• Common Gotchas: Top mistakes and how to avoid them
• Workflow Patterns: 4 proven architectural patterns
• Code Node Guide: Python code with proper outputs schema

dify-workflow-writer/
├── SKILL.md                    # Main skill file
├── README.md                   # This file
├── references/
│   ├── variable-syntax.md      # Variable reference syntax
│   ├── common-gotchas.md       # Troubleshooting guide
│   └── node-templates.md       # All node type templates
└── templates/
    ├── minimal-workflow.yaml   # Starter template
    ├── llm-chain-workflow.yaml # Multi-LLM pattern
    └── http-llm-workflow.yaml  # API + LLM pattern

User: Create a Dify workflow that analyzes articles using GPT-4
Claude: [Uses dify-workflow-writer skill to generate complete DSL]

User: My Dify workflow import fails, here's the DSL...
Claude: [Identifies variable syntax errors, missing outputs schema, etc.]

This skill was created by synthesizing information from the following sources:

• Dify Workflow Documentation - Official workflow guide
• Dify Node Types - All node type documentation
• Dify Code Node - Code node specifications
• Dify LLM Node - LLM node configuration
• Dify IF/ELSE Node - Conditional branching
• Dify HTTP Request Node - HTTP configuration
• Dify Iteration Node - Loop processing
• Dify Error Handling - Error strategies

• Awesome-Dify-Workflow - Community workflow collection
• Dify Blog: Workflow Introduction - Feature overview
• Dify Blog: Workflow Debugging - Debug features
• Dify Blog: Iteration Update - Iteration patterns

• #22389 - Output variable "error" causes JS execution error
• #6871 - Failed to parse result in Code node
• #3643 - DSL import workflow loading issues
• #7598 - DSL export missing features
• #4168 - HTTP request save issues

• n8n-skills - Structure and format inspiration
• n8n-mcp - MCP integration patterns

• dify-mcp-server - Dify workflow MCP integration
• dify-tools-bridge - Dify tools to MCP bridge

• /websites/docs_dify_ai-zh-hans - 1617 code snippets
• /langgenius/dify - 743 code snippets
• /langgenius/dify-docs-mintlify - 1208 code snippets

This skill was developed using real DSL files from the BestBlogs.dev project:

• flows/Dify/dsl/BestBlogs 文章初评流程.yml - Article filtering workflow
• flows/Dify/dsl/BestBlogs 文章分析流程.yml - Article analysis workflow
• flows/Dify/dsl/BestBlogs 文章分析结果翻译.yml - Translation workflow

To improve this skill:

1. Add new gotchas to references/common-gotchas.md
2. Add node templates to references/node-templates.md
3. Add workflow patterns to SKILL.md
4. Update this README with new sources

MIT - Feel free to use and modify.

Created with Claude Code, inspired by the n8n-skills project structure.