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/jhey-tompkins.md
View on GitHub# Jhey Tompkins' Animation Principles
These are context-dependent interpretive defaults, not designer-authored authority or universal aesthetic rules. Apply the actual user direction, purpose, frequency, accessible state and measured consequence; purposeful artistic expression remains available.
Jhey Tompkins (@jh3yy) is a design engineer known for pushing the boundaries of CSS and creative coding. His approach emphasizes **playful experimentation** — learning through building whimsical projects where the joy of creation drives skill development.
This file is Jhey's **philosophy and decision frameworks** — the judgment for *creative expression* and *easing personality*. Implementation code lives in `motion-cookbook.md` (cross-referenced below).
---
## Core Philosophy: Learn Through Play
> "I went from 'I want to learn X, so how do I fit it into Y' to 'I want to make Y, can I learn X to do it?'"
His key question for any interaction: **"What could this become?"**
**The motivation should be making something cool — learning is a happy side effect.**
### Core Beliefs
- **No idea is a bad idea** — Document every spark, however weird
- **Don't ask "Why?" or "Is this practical?"** — Make what brings you joy first
- **"Useless" demos teach real skills** — CSS art teaches clip-path mastery, border-radius tricks, stacking contexts
- **Lateral learning** — Building diverse demos trains you to switch contexts and rise to challenges
- **You'll never have time to make everything** — And that's okay. The act of documenting ideas matters.
**Keep notebooks everywhere** — including by your bed. Creative sparks happen at random times.
---
## When to Apply Jhey's Mindset
- Creative sites, portfolios, kids apps — contexts where delight is the point
- Learning new techniques
- Personal projects and experiments
- When you're stuck in a creative rut
- Exploring what's possible with new CSS features
---
## The Golden Rule (Even in Play)
> "The best animation is that which goes unnoticed."
Even in playful contexts, effective motion enhances the experience without demanding attention, feels natural and expected, serves the approved experiential or functional purpose, and doesn't fatigue users on repeated interactions.
---
## Easing Has Personality (Decision Framework)
> "Duration is all about timing, and timing has a big impact on the movement's naturalness."
Each easing curve communicates something. **Context matters more than rules.**
> "You wouldn't use 'Elastic' for a bank's website, but it might work perfectly for an energetic site for children."
Brand personality should drive easing choices — a playful brand can use bouncy/elastic easing, a professional brand should use subtle springs or `ease-out`.
**When NOT to use bouncy/elastic easing:**
- Professional/enterprise applications
- Frequently repeated interactions (gets tiresome)
- Error states or serious UI
- When users need to complete tasks quickly
(Easing-feel reference table and the `linear()` recipe for pure-CSS bounce/elastic/spring → cookbook §2.)
---
## Signature Techniques (decision context — code in cookbook)
| Technique | When Jhey reaches for it | Cookbook |
|-----------|--------------------------|----------|
| `linear()` function | Pure-CSS bounce, elastic, spring effects without JS | §2 |
| `@property` | Animating CSS custom properties — type declaration unlocks interpolation | §7 |
| Decomposed transforms | Curved motion paths impossible with a monolithic transform | §7 |
| `animation-fill-mode` | Delayed fade-in sequences — `backwards` prevents the pre-animation flash | §1 |
| Negative delays | "Already in progress" stagger effects | §2 |
| Scoped CSS variables | Varied behavior from a single animation definition | §7 |
| 3D CSS ("think in cubes") | Decompose 3D objects into cuboids; `preserve-3d` + `perspective` | §8 |
| Scroll-driven with duration | Decouple animation timing from scroll speed | §14 |
---
## Why "Useless" CSS Art Matters
CSS art teaches real skills that transfer to production: clip-path mastery, border-radius tricks, stacking contexts, complex gradients, pseudo-element layering. For complex illustrations — break into simple shapes, use pseudo-elements liberally, layer with z-index carefully, use CSS variables for repeated values, don't fear many elements.
---
## When to Experiment vs. Ship
| Situation | Approach |
|-----------|----------|
| Learning a new CSS feature | Build something weird and fun |
| Portfolio piece | Push boundaries, show creativity |
| Personal project | Follow your joy |
| Client work | Preserve approved playful expression and apply production accessibility, reliability and polish |
| High-frequency tool | Apply Emil's restraint instead |
Playful expression can be the production goal for a creative brand, portfolio or campaign. Combine it with relevant restraint, access and performance checks rather than excluding it merely because the work is for a client.
---
## Common Mistakes (Jhey's Perspective)
- **Filtering ideas based on "usefulness" too early** — Make first, judge later
- **Not documenting random creative sparks** — Keep notebooks everywhere
- **Thinking CSS art is useless** — It teaches real skills
- **Focusing on "How do I learn X?" instead of "How do I make Y?"** — Let ideas drive learning
- **Following tutorials without experimenting** — Tutorials teach techniques; experimentation teaches problem-solving
- **Giving up when something doesn't work** — The struggle is where learning happens
---
## Jhey vs. Emil vs. Jakub
| Aspect | Jhey | Emil | Jakub |
|--------|------|------|-------|
| **Focus** | Playful experimentation | Restraint & speed | Subtle polish |
| **Key question** | "What could this become?" | "Should this animate?" | "Is this subtle enough?" |
| **Signature technique** | CSS custom properties | Frequency-based decisions | Blur + opacity + translateY |
| **Ideal context** | Learning & exploration | High-frequency tools | Production polish |
**When to use Jhey**: You're building something where delight is the goal, exploring what's possible, or learning a new technique. The skills transfer to production work later.
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 |