azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

sync: auto-sync from GURU-5070 at 2026-06-03 20:07:24

Browse Source 
Author: Mike Swanson
Machine: GURU-5070
Timestamp: 2026-06-03 20:07:24
This commit is contained in:
Mike Swanson
2026-06-03 20:07:28 -07:00
parent 10e8d7b6bb
commit 37ccc5f35c
12 changed files with 1241 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
.grok/skills/human-flow/README.md Normal file
View File

@@ -0,0 +1,20 @@
# 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.

19
.grok/skills/human-flow/SKILL.md Normal file
View File

@@ -0,0 +1,19 @@
---
name: human-flow
description: >
A UI/UX scanner that specializes in detecting interaction patterns unintuitive or inefficient for humans using a mouse and keyboard.
Expands on frontend-design and impeccable by focusing on real human workflow friction: motor control (Fitts's Law, target sizing, precision),
discoverability (affordances, hover vs always-visible), keyboard parity (full navigation and activation without mouse),
feedback loops, task efficiency, and forgiving interaction models.
Use when: Use when reviewing or building any interactive UI, especially data-heavy tools, dashboards, lists, forms, and complex workflows.
---
**Grok skill.** This maps to the shared skill in `.claude/skills/human-flow/SKILL.md`.
Read the core skill definition and follow its instructions, adapting for the Grok environment (use run_terminal_command for any scripts, spawn_subagent for parallel analysis passes if useful, the full toolset for deep code inspection, and image_gen/image_edit only if generating visual mocks of improved interactions).
The full heuristics, scanner implementation, and report templates are in the `.claude` version. Use this wrapper to surface the skill under Grok's command system.
This skill supports a dedicated **"Fancy as Fuck"** mode (via natural language "human-flow fancy ..." or the `--fancy` script flag) for beauty, micro-interactions, elegant transitions, and tasteful delight — after core friction work is addressed.
It explicitly supports "useful decoration": beauty and panache are encouraged when they make the interface *more useful* (better mental models, reduced anxiety, clearer guidance, stronger emotional connection, etc.). The mode carefully distinguishes between high-density internal tools (restraint) and surfaces that benefit from more expressive elegance. Gratuitous prettiness is actively discouraged. "In the course of being as useful as possible, do it with panache."