interaction-patterns

interaction-patterns is a skill for Claude Code, Codex from aneja5/forge-skills. It costs 54 tokens per session (1,445 once invoked), scanned A, original, MIT.

A set of shared rules for how people interact with interface elements, such as modals, bottom sheets, loading states, gestures, and destructive actions. It also covers keyboard behavior, scrolling, and touch-target sizes.

In plain words
What is it for?
Use it to decide interaction behavior before building features, including when to expand, navigate, confirm, undo, or show loading feedback.
Why use it?
It keeps interactions predictable across screens and devices instead of making each feature behave differently.

Skill for Claude CodeCodex

Part of the forge-skills plugin — 42 skills, 36 commands, 13 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/aneja5/forge-skills/interaction-patterns
Any agent
npx skills add aneja5/forge-skills --skill interaction-patterns
Clone the repo
git clone --depth 1 https://github.com/aneja5/forge-skills

Made for: Claude Code, Codex.

Or install forge-skills, the plugin that ships this one along with the rest of its 42 skills, 36 commands, 13 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for interaction-patterns

README.md
[![agentmods](https://agentmods.dev/badge/skills/aneja5/forge-skills/interaction-patterns.svg)](https://agentmods.dev/skills/aneja5/forge-skills/interaction-patterns)
Your own site
<a href="https://agentmods.dev/skills/aneja5/forge-skills/interaction-patterns"><img src="https://agentmods.dev/badge/skills/aneja5/forge-skills/interaction-patterns.svg" alt="Measured on agentmods" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,445 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00054 $0.01445
Opus 5 $0.00027 $0.00723
Sonnet 5 $0.00011 $0.00289
Haiku 4.5 $0.00005 $0.00145

Measured yesterday against content hash f767174de88c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

interaction-patterns scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/interaction-patterns/SKILL.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Interaction Patterns

Overview

Define the canonical interaction for every UI primitive before features get built. Output is .forge/interaction-patterns.md — the decision tree for each interaction (expand vs navigate, modal vs bottom sheet, optimistic vs pessimistic UI, undo vs confirm), the tap-target minimums, the keyboard and scroll behavior, and the documented anti-patterns. Paired with design-system (which defines the look) and accessibility (which defines the floor).

When to Use

  • A new product or major feature is being designed and no interaction conventions exist
  • Mobile and desktop are drifting (centered modals on mobile, no swipe affordances)
  • Destructive actions have inconsistent UX (some have confirm, some have undo, some have neither)
  • A new component category is being introduced (e.g., first time adding command palette, drawer, popover)
  • Loading states are inconsistent (skeletons on one page, spinners on another)

When NOT to Use

  • A single interaction tweak inside one screen — that's incremental-implementation
  • Backend-only services
  • Accessibility-specific decisions (those go in accessibility)

Common Rationalizations

Thought Reality
"Desktop patterns work on mobile" Centered dialogs on mobile are unreachable with one thumb. Modal trap UX on a touchscreen is hostile.
"Users will figure it out" If it needs figuring out, it's broken. Every interaction that needs explanation costs a support ticket.
"We don't need loading states for fast operations" Fast on your dev machine is slow on a train in rural India. The user can't see your machine.
"Undo is too complex" Undo is cheaper than a confirmation dialog and faster than user anxiety. The only complex undo is the one nobody designed for.
"Swipe is obvious from native apps" Swipe with no visual affordance is a hidden feature. Discoverability requires a hint.
"Optimistic UI is risky" The risk is rollback messaging, not optimism. Pessimistic UI is a 300ms spinner every interaction.

Read the full file on GitHub · 104 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 104 lines · 54 tokens per session scan A f767174de88c

Subscribe to this mod's changes

interaction-patterns is a skill published in the GitHub repository aneja5/forge-skills (3 stars, last pushed 3mo ago), licensed MIT. It adds 54 tokens to every session and 1,445 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

designlang-tokens

Use when styling UI for cal.com — references the extracted design system tokens instead of inventing colors, spacing, or typography.

Manavarya09/design-extract · 30 tokens

design-to-code-check

Check alignment between a specific design specification and its code implementation — a focused, single-component or single-screen comparison. Trigger when someone says: does this match the design, check implementation, design code alignment, what's different between the design and the build, spec check…

murphytrueman/design-system-ops · 95 tokens

brand-visual-language

A brand's visual tone — playful or serious, rounded or angular — should be consistent across all UI elements. Shape language in typography, border-radius, and iconography communicates personality before a single word is read. Use when establishing a design system, choosing icon libraries, setting border-radius tokens…

dembrandt/dembrandt-skills · 68 tokens

micro-interactions

Micro-interactions are small, purposeful animations and responses that reward the user and make the interface feel alive — an animated icon, a satisfying toggle, a subtle reveal. Borrowed from the natural world, they add delight without distraction. Use when designing interactive components, success states, toggles…

dembrandt/dembrandt-skills · 70 tokens

elevation-and-depth

Elevation — subtle shadows and layering — communicates visual hierarchy by lifting elements above the surface. Combined with border-radius, it creates the tactile quality of cards, modals, and interactive surfaces. Use when designing cards, dropdowns, modals, tooltips, or any floating UI element.

dembrandt/dembrandt-skills · 62 tokens

loading-states-and-perceived-performance

Manage user expectations during wait times with appropriate loading states — from simple spinners to complex skeleton screens and staggered animations. Perceived performance is often more important than actual load time. Use when designing data-heavy components, handling API calls, building hero sections, or improving…

dembrandt/dembrandt-skills · 68 tokens