css-animations — Claude Code skill: seeking CSS animations
Provides rules for authoring CSS animations that HyperFrames can seek deterministically during video preview and final rendering.
Apache-2.0 271 installs ★ 484 updated 2026-08-15
npx skills add boraoztunc/skills --skill css-animations -a claude-codeWhat css-animations does
This skill guides coding assistants in structuring CSS keyframes for the HyperFrames css runtime adapter. The adapter locates elements with computed animation-name values, controls browser Animation handles, or pauses motion using a negative animation-delay fallback.
Animated DOM nodes must exist before runtime setup finishes and require a data-start attribute. Infinite animations fail to seek properly in runtimes without WAAPI support, which is why finite values for animation-iteration-count and animation-fill-mode: both are mandatory.
Compositions are verified with npx hyperframes lint and npx hyperframes validate.
What it helps with
- author deterministic CSS keyframes for video rendering
- stagger element motion using CSS variables and data attributes
- prepare decorative CSS loops compatible with HyperFrames seeking
Example prompts for the agent
- Create a pulse ring animation compatible with the HyperFrames CSS adapter
- Build a staggered dot-pop entrance using CSS keyframes and data-start
- Audit these CSS keyframes for deterministic seeking in HyperFrames
How to install css-animations
1Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill css-animations -a claude-code2Manually: put the files in place
~/.claude/skills/css-animations/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/css-animations/
1Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill css-animations -a codex2Manually: put the files in place
.agents/skills/css-animations/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill css-animations -a cursor2Manually: put the files in place
.cursor/skills/css-animations/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install boraoztunc/skills css-animations2Manually: put the files in place
.github/skills/css-animations/SKILL.md1Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill css-animations -a gemini-cli2Platform CLI
gemini skills install https://github.com/boraoztunc/skills --path css-animationsManually: put the files in place
.devin/skills/css-animations/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add boraoztunc/skills --skill css-animations -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about css-animations
How do I install css-animations in Claude Code?
Run npx skills add boraoztunc/skills --skill css-animations -a claude-code.
What does the css-animations skill do?
It defines patterns for building CSS keyframes that HyperFrames can seek frame by frame during preview and render stages.
Why should infinite CSS animations be avoided?
Environments lacking native WAAPI handles rely on negative animation-delay, which cannot map unbounded timelines.
Source text
SKILL.md · Apache-2.0
---
name: css-animations
description: CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.
---
# CSS Animations for HyperFrames
HyperFrames can seek CSS keyframe animations through its `css` runtime adapter. Use this for simple repeated motifs, background motion, shimmer, glow, masks, and non-sequenced decoration.
For scene choreography, GSAP is usually clearer. CSS animations work best when the motion belongs to one element and has a fixed duration.
## Contract
- Put the animated element in the DOM before runtime initialization finishes.
- Give timed elements a `data-start` value so local animation time matches the clip.
- Use finite `animation-duration` and `animation-iteration-count` because the negative-delay fallback cannot represent unbounded duration in environments without WAAPI-backed CSS animations.
- Prefer `animation-fill-mode: both` so seeked states hold before and after active motion.
- Avoid wall-clock JavaScript, hover-triggered state, and class toggles that depend on user events.
The adapter discovers elements with computed `animation-name`, seeks their browser `Animation` handles when available, and falls back to pausing with negative `animation-delay`.
## Basic Pattern
```html
<div
id="pulse-ring"
class="clip pulse-ring"
data-start="0"
data-duration="4"
data-track-index="2"
></div>
<style>
.pulse-ring {
width: 280px;
height: 280px;
border: 4px solid rgba(255, 255, 255, 0.7);
border-radius: 50%;
animation-name: pulse-ring;
animation-duration: 1200ms;
animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
animation-iteration-count: 3;
animation-fill-mode: both;
}
@keyframes pulse-ring {
from {
opacity: 0;
transform: scale(0.82);
}
35% {
opacity: 1;
}
to {
opacity: 0;
transform: scale(1.18);
}
}
</style>
```
## Stagger Pattern
Use CSS custom properties to avoid duplicating keyframes:
```html
<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
<span style="--i: 0"></span>
<span style="--i: 1"></span>
<span style="--i: 2"></span>
</div>
<style>
.dots span {
display: inline-block;
width: 18px;
height: 18px;
margin-right: 10px;
border-radius: 50%;
background: currentColor;
animation: dot-pop 900ms ease-out both;
animation-delay: calc(var(--i) * 120ms);
}
@keyframes dot-pop {
from {
opacity: 0;
transform: translateY(18px) scale(0.75);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
</style>
```
## Good Uses
- Decorative loops with a known repeat count.
- Mask, glow, shimmer, grain, and subtle parallax layers.
- Simple one-element entrances where a full JS timeline would be excessive.
## Avoid
- Infinite CSS animations unless you have verified the browser exposes seekable WAAPI-backed CSS animation handles. Prefer a finite iteration count covering the visible duration.
- Animating layout properties like `top`, `left`, `width`, or `height` when transforms work.
- Relying on hover, focus, scroll, or media queries to trigger render-critical motion.
- Changing animation classes after startup unless another deterministic timeline controls that change.
## Validation
After editing CSS animation compositions:
```bash
npx hyperframes lint
npx hyperframes validate
```
## Credits And References
- HyperFrames adapter source: `packages/core/src/runtime/adapters/css.ts`.
- MDN CSS animation documentation: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/animation
- MDN `animation-fill-mode`: https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode
© boraoztunc · Apache-2.0 · boraoztunc/skills