When Stuck - Problem-Solving Dispatch
Dispatch to the right problem-solving technique based on how you're stuck
animation-motion
CSS animations, transitions, and scroll-driven effects with accessibility (prefers-reduced-motion). Use when adding motion, hover effects, loading states, or scroll-based animations.
Full skill instructions
This skill covers CSS animations and transitions with a focus on accessibility (respecting user motion preferences) and performance (avoiding jank and layout thrashing).
Related: For CSS-only interactive patterns (tabs, accordions, toggles without JavaScript), see the
progressive-enhancementskill.
Motion should be:
prefers-reduced-motion preferencesAlways start with reduced motion as the default, then add motion for users who haven't opted out.
/* Base: no motion (reduced motion default) */
.element {
transition: none;
}
/* Add motion only when user hasn't requested reduced motion */
@media (prefers-reduced-motion: no-preference) {
.element {
transition: transform 0.3s ease, opacity 0.3s ease;
}
}
| Approach | Problem |
|---|---|
| Motion first, then remove | Users see flash of motion before media query applies |
| Reduced first, then add | Safe default, motion is progressive enhancement |
prefers-reduced-motion Media Query/* User prefers reduced motion */
@media (prefers-reduced-motion: reduce) {
* {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
}
}
Instead of removing all motion, provide alternatives:
/* Full animation for users without preference */
@media (prefers-reduced-motion: no-preference) {
.card {
transition: transform 0.3s ease, box-shadow 0.3s ease;
}
.card:hover {
transform: translateY(-4px);
box-shadow: var(--shadow-lg);
}
}
/* Subtle alternative for reduced motion */
@media (prefers-reduced-motion: reduce) {
.card {
transition: box-shadow 0.15s ease;
}
.card:hover {
box-shadow: var(--shadow-md);
}
}
const prefersReducedMotion = window.matchMedia(
'(prefers-reduced-motion: reduce)'
).matches;
if (prefersReducedMotion) {
// Use instant transitions or skip animations
element.style.transition = 'none';
} else {
// Full animation
element.animate(keyframes, options);
}
These properties can be animated without triggering layout or paint:
| Property | Use For |
|---|---|
transform | Movement, scaling, rotation |
opacity | Fade in/out |
filter | Blur, brightness (GPU accelerated) |
/* GOOD: Compositor-only */
.card:hover {
transform: translateY(-4px) scale(1.02);
opacity: 0.9;
}
These trigger expensive layout recalculations:
| Property | Problem |
|---|---|
width, height | Layout recalc |
top, left, right, bottom | Layout recalc |
margin, padding | Layout recalc |
border-width | Layout recalc |
font-size | Layout + text reflow |
/* BAD: Triggers layout */
.card:hover {
margin-top: -4px; /* Layout thrashing */
height: 110%; /* Layout thrashing */
}
/* GOOD: Use transform instead */
.card:hover {
transform: translateY(-4px) scaleY(1.1);
}
Use will-change sparingly for known animations:
/* Only use for elements that WILL animate */
.animated-element {
will-change: transform, opacity;
}
/* Remove after animation completes */
.animated-element.animation-done {
will-change: auto;
}
Warning: Don't apply will-change to many elements—it consumes memory.
:root {
/* Duration scale */
--duration-instant: 0.1s;
--duration-fast: 0.15s;
--duration-normal: 0.3s;
--duration-slow: 0.5s;
/* Easing functions */
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);
}
/* Hover lift effect */
@media (prefers-reduced-motion: no-preference) {
.card {
transition:
transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: var(--shadow-md);
}
}
/* Focus ring */
@media (prefers-reduced-motion: no-preference) {
button {
transition: outline-offset var(--duration-instant) var(--ease-out);
}
button:focus-visible {
outline: 2px solid var(--focus-color);
outline-offset: 2px;
}
}
/* Fade in */
@media (prefers-reduced-motion: no-preference) {
.fade-in {
animation: fadeIn var(--duration-normal) var(--ease-out);
}
}
@keyframes fadeIn {
from { opacity: 0; }
to { opacity: 1; }
}
/* Subtle pulse for attention */
@keyframes pulse {
0%, 100% { transform: scale(1); }
50% { transform: scale(1.05); }
}
@media (prefers-reduced-motion: no-preference) {
.notification-badge {
animation: pulse 2s var(--ease-in-out) infinite;
}
}
/* Reduced motion alternative: no animation */
@media (prefers-reduced-motion: reduce) {
.notification-badge {
animation: none;
}
}
/* Spinner that respects reduced motion */
@keyframes spin {
to { transform: rotate(360deg); }
}
.spinner {
width: 24px;
height: 24px;
border: 2px solid var(--border-color);
border-top-color: var(--primary-color);
border-radius: 50%;
}
@media (prefers-reduced-motion: no-preference) {
.spinner {
animation: spin 1s linear infinite;
}
}
@media (prefers-reduced-motion: reduce) {
.spinner {
/* Static indicator or pulsing opacity */
animation: none;
border-style: dotted;
}
}
@keyframes shimmer {
0% { background-position: -200% 0; }
100% { background-position: 200% 0; }
}
.skeleton {
background: linear-gradient(
90deg,
var(--surface-color) 25%,
var(--background-alt) 50%,
var(--surface-color) 75%
);
background-size: 200% 100%;
}
@media (prefers-reduced-motion: no-preference) {
.skeleton {
animation: shimmer 1.5s infinite;
}
}
@media (prefers-reduced-motion: reduce) {
.skeleton {
animation: none;
background: var(--background-alt);
}
}
@keyframes fadeSlideUp {
from {
opacity: 0;
transform: translateY(10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
@media (prefers-reduced-motion: no-preference) {
.animate-in {
animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
}
/* Staggered children */
.animate-in > * {
animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
}
.animate-in > *:nth-child(1) { animation-delay: 0ms; }
.animate-in > *:nth-child(2) { animation-delay: 50ms; }
.animate-in > *:nth-child(3) { animation-delay: 100ms; }
.animate-in > *:nth-child(4) { animation-delay: 150ms; }
}
@media (prefers-reduced-motion: reduce) {
.animate-in,
.animate-in > * {
animation: none;
opacity: 1;
transform: none;
}
}
@keyframes scaleIn {
from {
opacity: 0;
transform: scale(0.9);
}
to {
opacity: 1;
transform: scale(1);
}
}
@media (prefers-reduced-motion: no-preference) {
dialog[open] {
animation: scaleIn var(--duration-fast) var(--ease-out);
}
}
For page transitions (progressive enhancement):
/* Enable view transitions */
@view-transition {
navigation: auto;
}
/* Default crossfade */
::view-transition-old(root),
::view-transition-new(root) {
animation-duration: var(--duration-normal);
}
/* Respect reduced motion */
@media (prefers-reduced-motion: reduce) {
::view-transition-old(root),
::view-transition-new(root) {
animation-duration: 0.01ms;
}
}
/* Named transitions for specific elements */
.hero-image {
view-transition-name: hero;
}
::view-transition-old(hero),
::view-transition-new(hero) {
animation-duration: var(--duration-slow);
}
Modern CSS scroll-driven animations (progressive enhancement):
/* Fade in on scroll */
@keyframes fadeInOnScroll {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
@media (prefers-reduced-motion: no-preference) {
.scroll-reveal {
animation: fadeInOnScroll linear both;
animation-timeline: view();
animation-range: entry 0% entry 100%;
}
}
@media (prefers-reduced-motion: reduce) {
.scroll-reveal {
opacity: 1;
transform: none;
}
}
@media (prefers-reduced-motion: no-preference) {
button {
transition: transform var(--duration-instant) var(--ease-out);
}
button:active {
transform: scale(0.98);
}
}
.toggle-track {
width: 44px;
height: 24px;
background: var(--surface-color);
border-radius: 12px;
}
.toggle-thumb {
width: 20px;
height: 20px;
background: white;
border-radius: 50%;
transform: translateX(2px);
}
@media (prefers-reduced-motion: no-preference) {
.toggle-thumb {
transition: transform var(--duration-fast) var(--ease-out);
}
}
.toggle-input:checked + .toggle-track .toggle-thumb {
transform: translateX(22px);
}
.checkbox-icon {
stroke-dasharray: 24;
stroke-dashoffset: 24;
}
@media (prefers-reduced-motion: no-preference) {
.checkbox-icon {
transition: stroke-dashoffset var(--duration-fast) var(--ease-out);
}
}
.checkbox-input:checked + .checkbox-box .checkbox-icon {
stroke-dashoffset: 0;
}
| Animation Type | Duration | Reason |
|---|---|---|
| Micro-interaction | 100-150ms | Immediate feedback |
| Simple transition | 150-300ms | Noticeable but quick |
| Complex animation | 300-500ms | Time to follow |
| Page transition | 300-500ms | Context shift |
| Loading indicator | 1000-2000ms | One cycle visible |
Users perceive actions as instant if response is under 100ms. Use this for:
These can cause motion sickness or seizures:
| Pattern | Problem | Alternative |
|---|---|---|
| Parallax scrolling | Vestibular issues | Static or subtle parallax |
| Auto-playing video | Unexpected motion | Play on interaction |
| Flashing (>3Hz) | Seizure risk | No flashing |
| Large zooming | Vestibular issues | Fade transitions |
| Spinning/rotating | Disorientation | Fade or slide |
/* BAD: Aggressive parallax */
.parallax {
transform: translateY(calc(var(--scroll) * 0.5));
}
/* BETTER: Subtle or disabled with reduced motion */
@media (prefers-reduced-motion: reduce) {
.parallax {
transform: none;
}
}
/* BAD: Constant motion */
.attention-seeker {
animation: bounce 1s infinite;
}
/* BETTER: Limited iterations */
.attention-seeker {
animation: bounce 1s 3; /* Only 3 times */
}
/* BEST: Trigger on interaction */
.attention-seeker:hover {
animation: bounce 0.5s;
}
When adding animations or transitions:
prefers-reduced-motion is respectedtransform, opacity)will-change is used sparingly and removed after animationDispatch to the right problem-solving technique based on how you're stuck
TypeScript厳格モードによる型安全性設計を専門とするスキル。 📖 参照書籍: - 『Effective TypeScript』(Dan Vanderkam): 型設計 📚 リソース参照: - `resources/Level1_basics.md`: レベル1の基礎ガイド - `resources/Level2_intermediate.md`: レベル2の実務ガイド - `resources/Level3_advanced.md`: レベル3の応用ガイド - `resources/Level4_expert.md`: レベル4の専門ガイド - `resources/di...
Deploys applications to cloud Kubernetes (AKS/GKE/DOKS) with CI/CD pipelines. Use when deploying to production, setting up GitHub Actions, troubleshooting deployments. Covers build-time vs runtime vars, architecture matching, and battle-tested debugging.
19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration.
Converts architecture descriptions, module specs, or workflow docs into Mermaid diagrams. Use when visualizing brick module relationships, workflows (DDD, investigation), or system architecture. Supports: flowcharts, sequence diagrams, class diagrams, state machines, entity relationship diagrams,...
INVOKE FIRST before any code work. Validates git workflow (branch, issue, worklog) and checks approach. Use at START of every task and END before completing. Prevents skipped steps.
This skill should be used when working with browser-rendered artifacts (i.e. Bun, React/React Native) to proactively validate that development work on localhost is being built appropriately and to support debugging browser-rendered content. Use this skill after making frontend changes to verify t...
Lead Développeur - Coordination technique opérationnelle, code review, mentoring et livraison. Pair de web-dev-process au niveau OPÉRATIONS.
Monitor Docker workers, RQ queue health, and auto-scale workers (max 4). Use when: checking job progress, monitoring queue depth, scaling workers up/down, diagnosing slow processing, or waiting for jobs to complete. Referenced by data-quality skill during reprocessing.
Proactive quality guidance system that monitors artifact creation and provides real-time feedback on documentation quality
This skill should be used when the user wants to bump the version number in the workspace. It updates versions across all pyproject.toml files (root, tde, and tda packages) and the CHANGELOG.md to keep them synchronized.
Run comprehensive Rust code quality checks including compilation, linting, documentation, and tests. Use after completing code changes and before creating commits.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience