asgard-ai-platform/grad-flow
Apply flow theory to diagnose optimal experience conditions and design environments that balance challenge and skill for sustained engagement. Use this skill when the user needs to explain why users disengage from tasks, optimize task difficulty for peak performance, design learning progressions or gamification systems, or when they ask 'why do people lose focus', 'how to design for engagement', or 'what conditions produce peak performance'.
npx skills add https://github.com/asgard-ai-platform/skills --skill grad-flow
Flow theory (Csikszentmihalyi, 1990) describes a psychological state of complete absorption in an activity where a person's skills are fully engaged by a commensurate challenge. Flow occurs in a narrow channel between anxiety (challenge exceeds skill) and boredom (skill exceeds challenge), requiring clear goals, immediate feedback, and a perceived skill-challenge balance.
IRON LAW: Flow occurs ONLY when perceived challenge matches
perceived skill — too easy breeds boredom, too hard breeds
anxiety. Both dimensions are SUBJECTIVE perceptions, not
objective measurements.
Key assumptions:
Plot the target activity on the experience quadrant:
High Challenge
|
Anxiety | FLOW
|
------+----------
|
Apathy | Boredom
|
Low Skill ——————— High Skill
Check the three necessary conditions:
Common blockers: interruptions, ambiguous goals, delayed feedback, fixed difficulty (no adaptive scaling), multitasking, self-consciousness, external evaluation pressure.
## Flow Analysis: [Context]
### Current State Diagnosis
- Perceived skill level: [Low/Medium/High]
- Perceived challenge level: [Low/Medium/High]
- Current experience zone: [Flow/Anxiety/Boredom/Apathy]
### Precondition Check
| Condition | Status | Evidence |
|-----------|--------|----------|
| Clear goals | [Met/Unmet] | [observation] |
| Immediate feedback | [Met/Unmet] | [observation] |
| Skill-challenge match | [Met/Unmet] | [observation] |
### Flow Blockers
- [Blocker and its impact]
### Design Recommendations
1. [Challenge calibration change]
2. [Feedback mechanism improvement]
3. [Environmental modification]
Take asgard-ai-platform/grad-flow from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.