docs: professional README — problem, solution, all commands documented

[vamsivarma27]

Summary

Complete README overhaul. Goes from a basic usage file to a proper open source README that explains the full story.

What's in this README

• Badges — SkillsMP approved, version, MIT license, Agent Skills compatible, PRs welcome
• The Problem — explains UI lock-in clearly with real code examples showing what AI does wrong
• The Solution — before/after table showing exactly what changes vs what never changes
• Install — all 4 install methods (openskills, agent-skills-cli, manual project, manual global)
• Every command documented individually with its own section, explanation, and examples:
  • /ui-restructure — base command
  • --style — table with description + best use case per style
  • --mode — table showing what changes vs stays for each mode
  • --god-mode — full explanation of 100-user mindset, friction audit, 6 UX principles
  • --keep-tokens — when and why
  • --remove-tokens — difference from default
  • --grid — column breakdown by screen size
  • --density — spacing multiplier explained
  • --prompt — 3 real-world examples
• Combined examples — 5 real command combos
• What gets changed vs preserved — full table
• Framework + AI tool support — compatibility tables with install paths per tool
• Skill structure — visual tree with inline descriptions
• The polish standard — what every restructure guarantees
• Contributing + License

Test plan

• Preview README renders correctly on GitHub
• All badge URLs resolve
• Install commands are correct

🤖 Generated with Claude Code