README very hard to read, please rewrite, add example.

[sanjarcode]

I just wish to add run a command with a home screen icon. Why is this so hard?

1. What's the difference between .shortcuts, .shortcuts/tasks and .shortcut/icons. Which of these do I need to add an icon?
2. Instead of explaning internals, just add steps.
3. Please use toggle boxes for non-normal settings <details><summary></summary></details>.

can a generator command be written for this? or we can have a single config file.