TheGoat395/Codex-Skills / skills/design-motion-principles
design-motion-principles
VerifiedMotion through Kowalski, Krehel and Jhey lenses.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| agents/openai.yaml | config | 264 B |
| references/accessibility.md | markdown | 2.5 KB |
| references/anti-checklist.md | markdown | 13.4 KB |
| references/audit-checklist.md | markdown | 5.5 KB |
| references/creation-gotchas.md | markdown | 3.5 KB |
| references/demo-shell.html | other | 14.5 KB |
| references/emil-kowalski.md | markdown | 6.5 KB |
| references/jakub-krehel.md | markdown | 4.8 KB |
| references/jhey-tompkins.md | markdown | 6.1 KB |
| references/motion-cookbook.md | markdown | 18.3 KB |
| references/output-format.md | markdown | 18.0 KB |
| references/performance.md | markdown | 1.6 KB |
| references/report-template.html | other | 64.3 KB |
| workflows/audit.md | markdown | 12.7 KB |
| workflows/create.md | markdown | 4.4 KB |
references/accessibility.md
View on GitHub# Accessibility
**This is not optional.** Motion can cause discomfort, nausea, or distraction for many users.
---
## Respect User Preferences
```css
/* Base state is complete. Adapt these selectors to the owning component. */
.motion-reveal { opacity: 1; transform: none; filter: none; }
.motion-panel[data-state="closed"] { display: none; }
.motion-panel[data-state="open"] { display: block; }
@media (prefers-reduced-motion: no-preference) {
.motion-reveal { animation: motion-enter 180ms ease-out both; }
@keyframes motion-enter {
from { opacity: 0; transform: translateY(8px); }
to { opacity: 1; transform: none; }
}
}
@media (prefers-reduced-motion: reduce) {
.motion-reveal {
animation: none !important; /* resets delay as well as duration */
transition: none !important;
opacity: 1; transform: none; filter: none;
}
:root { scroll-behavior: auto; }
}
```
**What this does**: Keeps the reveal's settled state and the panel's functional open/closed state independent of motion. A global `0.01ms` duration reset cannot infer final states, clear every delay, or safely complete animation-event-driven application logic. Do not use it as proof of reduced-motion support. State, focus, announcements and action completion must come from application logic, not solely `animationend`/`transitionend`. Apply equivalent settled-state rules to each affected component and test delayed/looping/pinned/media paths as appropriate.
---
## Functional vs. Decorative Motion
| Type | Purpose | Reduced Motion Behavior |
|------|---------|------------------------|
| **Functional** | Indicates state changes, spatial relationships, orientation | May need alternative (instant state change, no transition) |
| **Decorative** | Pure delight, visual interest | Can be fully removed |
**The test**: Does removing this animation break the user's ability to understand what happened? If yes, it's functional.
---
## Motion Sensitivity Considerations
- Avoid large-scale motion (full-screen transitions, parallax)
- Avoid continuous or looping animations that can't be paused
- Provide pause controls for any ambient animation
- Be especially careful with vestibular triggers: zooming, spinning, parallax
---
## Implementation Checklist
- [ ] Tested with `prefers-reduced-motion: reduce` enabled
- [ ] No vestibular triggers (excessive zoom, spin, parallax)
- [ ] Looping animations can be paused
- [ ] Functional animations have non-motion alternatives
- [ ] Users can complete all tasks with animations disabled
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |