Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment.

Apache-2.0Auto-check passedProduct & Project Management

Install Immersion

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill immersion -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins immersion --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/immersion .claude/skills/immersion && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
immersion
GitHub stars
1.2k
Token cost
~2.8k tokens
SKILL.md length
1,484 words
Files
2 (incl. references)
Skills in repo
686
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment.

  • Designing for creative work
  • SKILL.md covers Conditions for immersion, Designing for immersion, When immersion is the right… and When immersion isn't the goal, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Any activity that benefits from extended focused attention

What it does

Immersion is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment. Use when designing for creative work, deep reading, gameplay, learning, or any activity that benefits from extended focused attention. Immersion requires removing distractions, providing clear feedback, calibrating challenge to skill, and respecting the user's flow state. Modern attention-driven products often work against immersion in…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lineage.md`).

It sits in Product & Project Management, covering Product metrics. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Designing for creative work
  • Any activity that benefits from extended focused attention

Example prompts

  • “/immersion”

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Immersion loads about 2.8k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 157 tokens; SKILL.md has 1,484 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~157
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 1,484 words, ~2,790 tokens.

Download SKILL.mdSave it as .claude/skills/immersion/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
immersion
description
Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment. Use when designing for creative work, deep reading, gameplay, learning, or any activity that benefits from extended focused attention. Immersion requires removing distractions, providing clear feedback, calibrating challenge to skill, and respecting the user's flow state. Modern attention-driven products often work against immersion in pursuit of engagement metrics; designs that genuinely serve immersion are increasingly distinctive.

Immersion

Definition. Immersion is the experience of being so absorbed in an activity that awareness of the external environment fades. The user is fully engaged with the task at hand; time perception alters; effort feels effortless. The closely-related concept of "flow" (Mihaly Csikszentmihalyi) describes the optimal state of immersion: high challenge matched to high skill, clear goals, immediate feedback, and absorption in the activity itself rather than in metrics about it.

Immersion is what makes some products feel essentially different from others. A truly immersive reading experience (a great book, a well-designed e-reader) is unlike scrolling through a feed; an immersive game is unlike a casual mobile game; an immersive creative tool is unlike a productivity app. The difference is the user's mental state: in immersion, they're absorbed; outside it, they're alternating attention.

Many modern products are designed for the opposite: maximizing engagement metrics through interruption, notification, and attention capture. These products are often financially successful but produce a different user experience — one of fragmentation rather than absorption.

The choice to design for immersion is increasingly distinctive. Products that respect deep attention and support flow states are rarer than products that interrupt it.

Conditions for immersion

The flow research (Csikszentmihalyi and many others) identifies several conditions for immersion:

Clear goals. The user knows what they're trying to do; the goal is concrete enough to focus on.

Immediate feedback. The user can see the effect of their actions in real time. They know whether they're succeeding or failing.

Challenge matched to skill. The activity is hard enough to require focus but not so hard as to overwhelm. Too easy = boredom; too hard = frustration.

Action and awareness merge. The user isn't thinking about the activity from outside; they're inside it.

Concentration on the task. The user's attention is fully on the activity, not split between it and other concerns.

Sense of control. The user feels they are directing the activity, not being directed by it.

Loss of self-consciousness. The user isn't worrying about how they appear or being judged; they're just doing.

Altered sense of time. Hours feel like minutes (or minutes feel like hours, depending on the activity).

Autotelic experience. The activity is intrinsically rewarding; the user is doing it for its own sake, not for an external reward.

When these conditions align, immersion happens. When they don't, the user's attention fragments.

Designing for immersion

Several design moves support immersion:

Remove distractions. Anything in the periphery competing for attention works against immersion. Notifications, popups, ads, animated banners, sticky elements — all reduce focus.

Provide clear, immediate feedback. The user's actions should produce visible results quickly. Unclear or delayed feedback breaks the action-awareness merger.

Calibrate difficulty. Tools should match the user's skill level. Too easy and the user gets bored; too hard and they give up. Many tools succeed by adapting to skill (more guidance for novices; more capability for experts).

Single focal point. The interface should foreground one thing — the user's current activity. Everything else should recede.

Quiet animation and interaction. Subtle, fast, organic. Not distracting from the activity.

Generous space and rhythm. Cramped layouts work against absorption; spacious ones support it.

Avoid metrics about the activity (in the moment). The user is in the activity; metrics about the activity (your streak, your time, your score) take them out of it. Some products defer metrics to between-session reviews.

Honor the activity's natural rhythm. Some activities benefit from no breaks; others from clear chapter breaks. Design respects the activity's structure.

When immersion is the right design goal

Creative work. Writing, drawing, music production, design. Sustained focused attention is essential.

Deep reading. Books, long-form articles, dense documentation.

Learning. Sustained study, working through problems, building skills.

Games. Many games depend on flow for their core experience.

Meditation and reflection. The activity is precisely about sustained attention.

Skilled physical activities. Tools that support sustained physical-skill activities (e.g., a guitar tuner used during practice) should not interrupt the activity.

When immersion isn't the goal

Quick utilities. A tool used for 30 seconds doesn't need to support immersion; it needs to do its job and leave.

Reference / lookup. Find an answer; close the tab. Immersion isn't the point.

Notification-driven workflows. Some products are inherently about responding to incoming events; immersion would conflict with the purpose.

Casual entertainment. Some entertainment is appropriately casual; immersion isn't necessary.

The principle is: when the activity benefits from sustained focused attention, design for immersion. When it doesn't, design for the appropriate other goal.

Sub-skills in this cluster

  • immersion-flow — Designing for flow specifically: clear goals, immediate feedback, challenge calibration. The most-researched aspect of immersion.
  • immersion-distraction-cost — The cost of breaking immersion: how interruptions cost cognitive resetting time, how notifications fragment attention, how to design environments that protect attention.

Worked examples

A writing tool designed for immersion

A focused writing tool: a clean canvas, a single column of text, no toolbar at the top, no notifications. The user types; words appear. There are no badges, no streaks, no metrics displayed during writing. Word count is available but in a small corner, easy to ignore.

The tool is intentionally quiet. The activity (writing) is the entire focus. Users who need this kind of tool find it; products that interrupt their writing with notifications or social features feel hostile.

Show full SKILL.md (613 more words)Show less
An e-reader designed for immersion

A reading app: pages of text, generous margins, a typeface designed for sustained reading, soft tap-to-turn pagination. No social features in the reading view. No notifications. The chrome is minimal and recedes after a moment.

The user is reading; the design supports being in the book.

A code editor in focus mode

Some code editors offer a "focus mode" or "zen mode" that hides all panels except the editor itself. The developer sees only their code; everything else is out of view.

The mode is requested at moments of deep work. The editor is otherwise full-featured but knows when to step back.

A creative tool with adaptive difficulty

A drawing tool offers different brush-control options based on user skill. Beginners get gentle defaults; advanced users can configure brushes precisely. The tool meets the user at their skill level, supporting flow.

This is challenge-skill calibration in action: the same tool feels approachable to a beginner and powerful to an expert because it adapts.

A meditation app designed for immersion

A meditation app starts a session with a brief setup (timer, sound), then becomes silent. No notifications during the session. The screen dims. The user's attention has nothing to compete with.

This is immersion as the entire product. The app's value is precisely that it supports focused attention.

A game with notification interruptions that fail at immersion

A puzzle game launches with frequent in-game popups: "Daily reward available!" "Friend just beat your score!" "Try our new mode!" The popups appear during gameplay, breaking concentration.

Players who wanted immersion leave for quieter games. Players who stay tolerate the interruptions but don't experience flow. The game's engagement metrics may look fine; the experience quality is poor.

The fix: defer notifications until between sessions. Let the actual gameplay be uninterrupted.

Anti-patterns

Notifications during the activity. A notification arrives while the user is in deep work. They look at it. They lose 15 minutes of attention rebuilding. The cost compounds across each notification.

Metrics displayed during the activity. A streak counter, a time tracker, a score that updates live. The user attends to the metric instead of the activity.

Forced social comparison. "Your friend just X." Pulls the user out of their own activity into comparison with others.

Interruptions for "engagement." Popups, banners, modal prompts that drive action. Each one fragments attention.

Misaligned challenge. A tool too easy or too hard for the user's skill level. Either bores or frustrates.

Cluttered interface during the activity. Too many panels, too many indicators, too many things in peripheral vision.

Penalties for stopping. A streak that ends if you skip a day. The penalty creates anxiety that reduces enjoyment of the activity.

Heuristic checklist

When designing for immersion, ask: Does the design protect the user's attention during the activity? Or does it compete for it? Is feedback during the activity supportive or distracting? Quiet, fast feedback supports; loud, slow feedback distracts. Is challenge calibrated? Too easy = boredom; too hard = frustration. Are notifications and interruptions deferred to between sessions? If not, you're working against immersion. Does the interface have a clear focal point? Single focus supports immersion.

  • Form Follows Function — immersive design has form that follows the function of supporting sustained attention.
  • Signal-to-Noise Ratio — immersion requires high signal-to-noise; distractions are noise.
  • Wabi-Sabi (restraint) — restraint supports immersion; clutter undermines it.
  • Aesthetic-Usability Effect — beautiful, calming designs support the entry into flow.
  • Mental Model — immersion depends on a stable mental model the user can operate within.
  • Feedback Loop — flow requires immediate feedback.

See also

  • references/lineage.md — origins in flow research, attention research, and design theory.
  • immersion-flow/ — sub-skill on designing for flow specifically.
  • immersion-distraction-cost/ — sub-skill on the cost of attention fragmentation.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/immersion of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Immersion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Immersion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Immersion this skillhashgraph-online/awesome-codex-plugins1.2k—~2.8kAutomated safety check: PassApache-2.0
Swarmaglitch-rabin/swarma173—~4.4kAutomated safety check: NotesMIT
Prdjuanandresgs/claude-ctrl193—~2.9kAutomated safety check: PassNone
AI Product Strategy InterviewerPrepLabsAI/InterviewMentor112—~4.5kAutomated safety check: PassMIT
Investigate MetricPostHog/posthog40k—~1.9kAutomated safety check: PassCustom licence
Product Manager Toolkitanbeime/skill7.6k—~3.1kAutomated safety check: PassNone

Similar skills

  • Swarma

    glitch-rabin/swarma

    Agent teams that run growth experiments and build their own playbook.

    173 GitHub stars~4.4k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check: notes
  • Prd

    juanandresgs/claude-ctrl

    Write structured feature specifications with problem statements, user journeys, use cases, functional requirements, and success metrics.

    193 GitHub stars~2.9k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • AI Product Strategy Interviewer

    PrepLabsAI/InterviewMentor

    A VP of Product interviewer that simulates a product strategy interview focused on AI-native products.

    112 GitHub stars~4.5k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • 产品经理必备利器!当面临海量需求排期、用户调研分析和PRD撰写等场景时,使用此工具可一键计算RICE得分、自动提炼访谈洞察并快速生成标准PRD文档,大幅提升需求决策与产品交付效率,让规划更科学。

    7.6k GitHub stars~3.1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Bmad Product Brief

    aj-geddes/claude-code-bmad-skills

    Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method.

    487 GitHub stars~1.7k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: notes

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Immersion

What does Immersion do?

Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment. Immersion is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Immersion — designing for sustained focus and engagement, where the user becomes absorbed in the activity and loses awareness of the surrounding environment.

When should I use Immersion?

Immersion fits situations like: designing for creative work; any activity that benefits from extended focused attention.

How do I install Immersion in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill immersion -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/immersion in hashgraph-online/awesome-codex-plugins) into .claude/skills/immersion in your project. Claude Code loads it when a task matches its description.

How do I install Immersion in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill immersion -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/immersion in hashgraph-online/awesome-codex-plugins) into .agents/skills/immersion in your project. Codex loads it when a task matches its description.

Can I use Immersion in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill immersion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/immersion, .gemini/skills/immersion, .github/skills/immersion and .opencode/skills/immersion in your project.

What does Immersion need to run?

SKILL.md names no scripts, command-line tools or credentials: Immersion is instructions for the agent only.

Does Immersion access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Immersion safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Immersion use?

Immersion is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Immersion use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Immersion?

Skills that share tags, products or a category with Immersion: Swarma (glitch-rabin/swarma, 173 stars), Prd (juanandresgs/claude-ctrl, 193 stars), AI Product Strategy Interviewer (PrepLabsAI/InterviewMentor, 112 stars) and Investigate Metric (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Immersion?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.