# human-flow (Grok wrapper)

See the full implementation and documentation in `.claude/skills/human-flow/`.

This skill is available as a first-class UI/UX scanner focused on real human mouse + keyboard workflow friction, with a powerful optional **"Fancy as Fuck"** mode for beauty, elegance, micro-interactions, transitions, view transitions, and refined delight.

Example natural language usage inside Grok:
- "human-flow scan the dashboard tables and action patterns"
- "human-flow fancy the interactive surfaces — evaluate for tasteful polish and appropriate elegance"
- "First do the human-flow friction pass, then run the fancy pass for beauty opportunities"

The scanner script can also be invoked directly:
```bash
node .claude/skills/human-flow/scripts/scan.mjs --path <frontend dir or file>
node .claude/skills/human-flow/scripts/scan.mjs --path <frontend dir or file> --fancy
```

The fancy mode comes with strong appropriateness guidance and explicitly supports "useful decoration." Beauty and panache are welcomed when they make the interface *more useful* (better mental models, reduced anxiety, clearer guidance, stronger emotional connection, etc.). The guiding principle is: "In the course of being as useful as possible, do it with panache."

It distinguishes between high-density internal tools (restraint) and surfaces that can benefit from more expressive, delightful "useful decoration." Gratuitous prettiness is actively discouraged.