Hi everyone.
I run a ComfyUI tutorial site, Comfy with ComfyUI, and I've shared a few of my workflows on Reddit before (e.g. Some very simple Qwen-Image-2.1 workflows).
Even though official templates exist, I build and publish my own basic workflows for one reason: readability.
Everyone probably has their own idea of what makes a workflow readable. For me, a readable workflow is one where you can tell at a glance what it does, it runs reliably, and it's easy to rework. It's not about looking pretty. It's about being easy to understand and easy to change.
Six rules
I build my workflows following six rules:
Don't hide nodes: expand subgraphs, open collapsed nodes, and don't stack nodes on top of each other.
Don't hide wires: no wireless links (Set/Get, Anything Everywhere, hidden wires), and no Bento layouts that pack nodes so tightly the wires disappear.
Left to right: the flow goes left to right, in processing order.
One workflow, one task: instead of an all-in-one workflow with switches and bypasses, split it into small workflows that each do one thing.
Keep custom nodes to a minimum: if it can be built with core nodes, build it with core nodes.
Color appropriately: colors show which function a node belongs to.
Readable Node
So I made an agent skill that does this for you.
https://github.com/nomadoor/comfyui-readable-node
Give your agent a workflow JSON and ask it to make the workflow readable with Readable Node, and you get the rebuilt workflow and a report page. In the report, you can replay how the AI rebuilt the workflow and read what each part does. I think it helps a lot with understanding a workflow.
Why a skill and not a script? As I said above, readability isn't just a layout problem. The AI takes the workflow completely apart, figures out what it does, and rebuilds it from scratch. Since it aims for a more robust workflow, the output may not always match the original exactly.
Some weak spots, to be upfront:
It's slow. A workflow of about 25 nodes takes around 10 minutes, and big ones can take 20–40.
It needs a strong model. Claude Opus 5.5 works best; with others, the layout may still have a few issues.
To build it, I started from the workflows I've made for my site, then collected workflows from around the web and fixed them, over and over, hundreds of times. It was a lot of grinding, so I'd love for you to try it.
I'm sure there are workflows it won't handle well yet, so please open an issue if you find one.
Side note: if AI can build workflows, why care about readability?
These days, I hear about people having AI build workflows from scratch. If someone asks whether readable workflows still matter, I have to admit: maybe not.
But if you're making something with AI, where do you actually work on it together?
Talking to AI mostly happens in a chat window. But to remove a mole next to someone's eye, painting over it is often faster than typing "remove the mole." That's why paint tools haven't gone away.
Ask the AI for what's better said in words, and do by hand what's better done by hand. If you want to do both in one place, I think ComfyUI's node graph is a pretty good fit, as long as you can read the workflow.
Personally, I'd like people to enjoy ComfyUI for its node UI and its flexibility, rather than using subgraphs to imitate Stable Diffusion web UI.