Agent skill

Loading States

by Owl-Listener in Owl-Listener/designer-skills

Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal.

MITAuto-check passed

Install Loading States

skills CLI
$ npx skills add Owl-Listener/designer-skills --skill loading-states -a claude-code

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

GitHub CLI
$ gh skill install Owl-Listener/designer-skills loading-states --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/Owl-Listener/designer-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/interaction-design/skills/loading-states .claude/skills/loading-states && 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
loading-states
GitHub stars
2.9k
Used in
1 other repo
Token cost
~479 tokens
SKILL.md length
210 words
Files
1
Skills in repo
107
Repo updated
First seen
Licence
MIT

At a glance

Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal.

  • Content takes time to arrive
  • SKILL.md covers What You Do, Loading Patterns, Duration Guidelines and Transition Behavior, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Loading States is an agent skill from Owl-Listener/designer-skills. Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal. Use when content takes time to arrive. For the latency budget itself use doherty-threshold; for success confirmation use feedback-patterns.

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Designer Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery. The licence is MIT.

When your agent uses it

  • Content takes time to arrive

Example prompts

  • “/loading-states”

What it can do on your machine

Read from SKILL.md and the folder at commit 9a6930c. 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

Loading States loads about 479 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 210 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~479

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 Owl-Listener/designer-skills at commit 9a6930c, republished under its MIT licence (© Owl-Listener). 210 words, ~479 tokens.

Download SKILL.mdSave it as .claude/skills/loading-states/SKILL.md (or your agent's skills folder).
name
loading-states
description
Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal. Use when content takes time to arrive. For the latency budget itself use `doherty-threshold`; for success confirmation use `feedback-patterns`.

Loading States

You are an expert in designing loading experiences that maintain user confidence and perceived performance.

What You Do

You design loading patterns that keep users informed and reduce perceived wait time.

Loading Patterns

Skeleton Screens

Show the layout shape before content loads. Use for known content structure. Animate with subtle shimmer.

Spinner/Progress

Indeterminate spinner for unknown duration. Determinate progress bar when progress is measurable. Keep spinners small and unobtrusive.

Progressive Loading

Load critical content first, enhance progressively. Lazy-load below-fold content. Blur-up images (low-res placeholder to full).

Optimistic UI

Show the expected result immediately. Reconcile with server response. Roll back if the action fails.

Placeholder Content

Show placeholder text/images while loading. Use realistic proportions. Transition smoothly to real content.

Duration Guidelines

  • Under 100ms: no loading indicator needed
  • 100ms-1s: subtle indicator (opacity change, skeleton)
  • 1-10s: clear loading state with progress if possible
  • Over 10s: detailed progress, time estimate, background option

Transition Behavior

  • Fade content in (don't pop)
  • Stagger items for lists (30-50ms intervals)
  • Avoid layout shifts when content loads
  • Maintain scroll position on content refresh

Best Practices

  • Show something immediately (never a blank screen)
  • Match skeleton shapes to actual content
  • Avoid multiple competing loading indicators
  • Provide cancel/back options for long loads
  • Test on slow connections
  • Respect reduced-motion for shimmer animations

© Owl-Listener, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in interaction-design/skills/loading-states of Owl-Listener/designer-skills.

Open the folder on GitHubat commit 9a6930c

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Owl-Listener/designer-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Loading States 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.

Loading States compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Loading States this skillOwl-Listener/designer-skills2.9k1 repos~479Automated safety check: PassMIT
Progressive Buildingn8n-io/n8n207k—~1.6kAutomated safety check: PassCustom licence
Finding ExperimentsPostHog/posthog40k—~783Automated safety check: PassCustom licence
Loading Indicatorsthedaviddias/Front-End-Checklist74k—~434Automated safety check: PassMIT
Font Loadingthedaviddias/Front-End-Checklist74k—~400Automated safety check: PassMIT
ExperimentsArize-ai/phoenix12k—~1.8kAutomated safety check: PassCustom licence

Similar skills

  • Official

    Load before build-workflow and before scoping or planning new workflows and feature additions, including requests spanning multiple workflows.

    207k GitHub stars~1.6k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Finding Experiments

    PostHog/posthog

    Official

    Resolves a PostHog experiment reference from natural language to a concrete experiment ID by browsing experiment-list (not feature-flag tools), with disambiguation when multiple experiments match.

    40k GitHub stars~783 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Loading Indicators

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Show loading indicators.

    74k GitHub stars~434 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Font Loading

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Optimize web font loading.

    74k GitHub stars~400 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Experiments

    Arize-ai/phoenix

    Run, read, and compare dataset-backed experiments to find evidence that a prompt or pipeline is improving.

    12k GitHub stars~1.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Lazy Loading

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Implement lazy loading for offscreen content.

    74k GitHub stars~487 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from Owl-Listener/designer-skills

All 107 skills in this repo
  • A B Test Design

    Owl-Listener/designer-skills

    Design an A/B experiment — hypothesis, variants, primary metric, and sample size.

    2.9k GitHub starsUsed in 1 repo~472 tokens
    Auto-check passed
  • Accessibility Test Plan

    Owl-Listener/designer-skills

    Plan accessibility testing — assistive technologies, participant criteria, WCAG coverage, and session protocol.

    2.9k GitHub starsUsed in 1 repo~478 tokens
    Auto-check passed
  • Aesthetic Usability

    Owl-Listener/designer-skills

    Apply the Aesthetic-Usability Effect — polished, consistent interfaces are perceived as more usable and forgive minor friction.

    2.9k GitHub starsUsed in 1 repo~678 tokens
    Auto-check passed
  • Affinity Diagram

    Owl-Listener/designer-skills

    Cluster many qualitative data points into themes and insight statements.

    2.9k GitHub starsUsed in 1 repo~520 tokens
    Auto-check passed
  • Animation Principles

    Owl-Listener/designer-skills

    Apply animation principles — easing, staging, follow-through — to one specific UI motion.

    2.9k GitHub starsUsed in 1 repo~492 tokens
    Auto-check passed
  • Business Design

    Owl-Listener/designer-skills

    Read financials, map competitive landscapes, and argue design decisions in the language of value.

    2.9k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed

Questions about Loading States

What does Loading States do?

Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal. Loading States is an agent skill from Owl-Listener/designer-skills. Design waiting experiences — spinners, skeletons, optimistic updates, and progressive reveal.

When should I use Loading States?

Loading States fits situations like: content takes time to arrive.

How do I install Loading States in Claude Code?

Run `npx skills add Owl-Listener/designer-skills --skill loading-states -a claude-code`. Or copy the skill folder (interaction-design/skills/loading-states in Owl-Listener/designer-skills) into .claude/skills/loading-states in your project. Claude Code loads it when a task matches its description.

How do I install Loading States in Codex?

Run `npx skills add Owl-Listener/designer-skills --skill loading-states -a codex`. Or copy the skill folder (interaction-design/skills/loading-states in Owl-Listener/designer-skills) into .agents/skills/loading-states in your project. Codex loads it when a task matches its description.

Can I use Loading States 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 Owl-Listener/designer-skills --skill loading-states -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/loading-states, .gemini/skills/loading-states, .github/skills/loading-states and .opencode/skills/loading-states in your project.

What does Loading States need to run?

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

Does Loading States 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 Loading States 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 Loading States use?

Loading States is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Loading States use?

About 479 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Loading States?

Skills that share tags, products or a category with Loading States: Progressive Building (n8n-io/n8n, 207k stars), Finding Experiments (PostHog/posthog, 40k stars), Loading Indicators (thedaviddias/Front-End-Checklist, 74k stars) and Font Loading (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Loading States?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/designer-skills, which has 2,854 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on September 5, 2026.

Source: Owl-Listener/designer-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.