Long Running Operation UX

Build or improve progress, cancellation, result handoff, and reliability when creating or changing a user-facing slow asynchronous action, model call, media job, queue, or multi-step workflow. Applies to batch size, concurrency, and rerun changes affecting the visible wait; do not wait for a stuck-action complaint. Exclude ordinary fast requests and backend-only changes with no user-facing operation affected.

201 stars 12 forksFrontend & Design

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add swyxio/skills --skill long-running-operation-ux
Manual install
git clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/long-running-operation-ux ~/.claude/skills/long-running-operation-ux

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Long-Running Operation UX

Match the solution to the actual user problem. Preserve accumulated workflow
lessons and the preferred stack without making advanced architecture mandatory.

## Activation

Apply this skill when creating or materially changing a user-facing action
that launches noticeable asynchronous work, including batch size, concurrency,
reruns and result handoff. Do not wait for the user to report that it looks
stuck. A backend change affecting a visible operation is in scope; a model
call with no user-facing wait is not sufficient by itself.

## Maturity profiles

### L0 — Blind button

A user action silently waits, appears stuck, or loses its result. This is the
failure to diagnose, not a maturity level to ship.

### L1 — Busy state

Use for short, predictable interactions. Acknowledge the click immediately,
show pending/completed/failed, prevent duplicate submits, restore controls,
and display the new result. Reuse existing component state.

### L2 — Honest wait

Use for a noticeable one-shot or an existing background job. Add elapsed time,
the real latest state, useful errors, and existing polling or subscriptions.
Preserve editable inputs, focus, prior results, and unrelated navigation.
Offer cancellation when requested or when an existing foreground operation can
actually be stopped. Do not require streaming, traces, or an orchestration
framework. A 30-second LLM call can remain L2.

### L3 — Stage trace
Read the full skill on GitHub

Details

Skill name
long-running-operation-ux
Repository
swyxio/skills
Path
long-running-operation-ux/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Long Running Operation UX skill do?

Build or improve progress, cancellation, result handoff, and reliability when creating or changing a user-facing slow asynchronous action, model call, media job, queue, or multi-step workflow. Applies to batch size, concurrency, and rerun changes affecting the visible wait; do not wait for a stuck-action complaint. Exclude ordinary fast requests and backend-only changes with no user-facing operation affected.

How do I install the Long Running Operation UX skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill long-running-operation-ux. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Long Running Operation UX popular?

It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.

Related skills

Accelevents API

201

swyxio/skills

Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.

Software Development12

Accelevents Speaker Sync

201

swyxio/skills

Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.

AI, LLMs & Agents12

Agents SDK

201

swyxio/skills

Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.

AI, LLMs & Agents12

Make Bot UI

100

adriannoes/awesome-agentic-ai

Use when building a custom UI (page, dashboard, buttons) that should wake a Grok Bot over a webhook, when the user must provide a webhook sender key, or when exposing that UI on Tailscale.

Frontend & DesignIn 2 lists27

Location Input

201

swyxio/skills

Build or improve city/country form inputs with accessible autocomplete, abbreviation matching, and optional browser-location suggestions. Use for applicant, profile, or registration location fields; street-address validation and exact geofencing require a different approach.

Frontend & Design12

Mobile Native

201

swyxio/skills

Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep links/widgets/shortcuts before local content is ready. Also use for iOS/iPadOS generated build configuration, signing/install/launch problems, and device playtesting. Keep existing native or cross-platform stacks; excludes browser-only responsive work and backend-only changes without native UX or delivery implications.

Frontend & Design12

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.