Install
$ agentstack add skill-caidanw-skills-modern-css ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Modern CSS
The CSS spec has evolved dramatically. Many old hacks — absolute-position centering, padding-top aspect ratios, JS scroll listeners, Sass color functions — now have clean, native replacements. This skill ensures you always reach for the modern approach first.
Reference: modern-css.com — all techniques sourced from this site. Visit individual pages for live demos and deeper explanations.
Support data: Browser support percentages represent global user coverage from caniuse.com, last updated February 2026. These numbers shift as browsers release updates — verify on caniuse if precision matters for a project.
How to Use This Skill
When writing or reviewing CSS:
- Always use techniques in the Widely Available tier (90%+ support) without asking.
If you spot legacy patterns, refactor them to the modern equivalent.
- Suggest techniques in the Newly Available tier (80–90% support). Mention they are
newly available and let the user decide. Offer a fallback if relevant.
- Ask first before using Limited Availability techniques ( * { margin-right: 16px; }
.grid > *:last-child { margin-right: 0; }
/ MODERN: gap on the container / .grid { display: flex; gap: 16px; }
[Reference →](https://modern-css.com/spacing-elements-without-margin-hacks/)
#### Aspect ratios — `aspect-ratio`
```css
/* OLD: padding-top percentage hack */
.wrapper { padding-top: 56.25%; position: relative; }
.inner { position: absolute; inset: 0; }
/* MODERN: aspect-ratio property */
.video-wrapper {
aspect-ratio: 16 / 9;
}
Positioning shorthand — inset
/* OLD: four separate properties */
.overlay { top: 0; right: 0; bottom: 0; left: 0; }
/* MODERN: inset shorthand */
.overlay {
position: absolute;
inset: 0;
}
Sticky headers — position: sticky
/* OLD: JS scroll listener + getBoundingClientRect */
// add/remove .fixed class based on scroll position
/* MODERN: sticky positioning */
.header {
position: sticky;
top: 0;
}
Responsive images — object-fit
/* OLD: background-image with background-size */
.card-image {
background-image: url(...);
background-size: cover;
background-position: center;
}
/* MODERN: object-fit on an img element */
img {
object-fit: cover;
width: 100%;
height: 200px;
}
Filling available space — stretch
/* OLD: calc workaround */
.full { width: calc(100% - 40px); }
/* MODERN: stretch keyword */
.full { width: stretch; }
/* fills container, respects margins */
Preventing scroll chaining — overscroll-behavior
/* OLD: JS wheel event preventDefault */
// modal.addEventListener('wheel', e => e.preventDefault(), { passive: false })
/* MODERN: overscroll-behavior */
.modal-content {
overflow-y: auto;
overscroll-behavior: contain;
}
Preventing scrollbar layout shift — scrollbar-gutter
/* OLD: force scrollbar or hardcode padding */
body { overflow-y: scroll; }
/* MODERN: reserve scrollbar space */
body { scrollbar-gutter: stable; }
Grid template areas — named areas
/* OLD: grid line numbers or floats */
.item { grid-column: 1 / 3; grid-row: 2; }
/* MODERN: named grid areas */
.layout {
display: grid;
grid-template-areas:
"header header"
"sidebar main"
"footer footer";
}
.header { grid-area: header; }
Modal dialogs — `` element
/* OLD: fixed overlay + JS open/close/ESC/focus-trap */
.overlay { position: fixed; z-index: 999; }
/* MODERN: native dialog with ::backdrop */
dialog { padding: 1rem; }
dialog::backdrop { background: rgb(0 0 0 / .5); }
/* JS: dialog.showModal() / dialog.close() */
Direction-aware layouts — logical properties
/* OLD: physical properties + RTL overrides */
margin-left: 1rem;
padding-right: 1rem;
[dir="rtl"] .box { margin-right: 1rem; }
/* MODERN: logical properties */
margin-inline-start: 1rem;
padding-inline-end: 1rem;
border-block-start: 1px solid;
Responsive components — @container
/* OLD: viewport-based media queries */
@media (min-width: 768px) {
.card { grid-template-columns: auto 1fr; }
}
/* MODERN: container queries */
.wrapper { container-type: inline-size; }
@container (width > 400px) {
.card { grid-template-columns: auto 1fr; }
}
Scroll snapping — scroll-snap
/* OLD: Slick/Swiper carousel or touch handlers */
// $('.carousel').slick({ ... })
/* MODERN: CSS scroll snap */
.carousel {
scroll-snap-type: x mandatory;
overflow-x: auto;
}
.carousel > * { scroll-snap-align: start; }
Selectors
Parent selection — :has()
/* OLD: JavaScript el.closest('.parent').classList.add(...) */
/* MODERN: :has() parent selector */
.card:has(img) {
grid-template-rows: auto 1fr;
}
Grouping selectors — :is()
/* OLD: repeat the full selector for each match */
.card h1, .card h2, .card h3, .card h4 { margin-bottom: 0.5em; }
/* MODERN: :is() grouping */
.card :is(h1, h2, h3, h4) { margin-bottom: 0.5em; }
Low-specificity resets — :where()
/* OLD: class-based resets with specificity issues */
.reset ul, .reset ol { margin: 0; }
/* MODERN: :where() has zero specificity */
:where(ul, ol) {
margin: 0;
padding-inline-start: 1.5rem;
}
Keyboard-only focus — :focus-visible
/* OLD: :focus fires on mouse click too, so people remove outlines (a11y fail) */
:focus { outline: 2px solid blue; }
/* MODERN: :focus-visible only shows for keyboard navigation */
:focus-visible {
outline: 2px solid var(--focus-color);
}
Color
Styling form controls — accent-color
/* OLD: appearance: none + rebuild the entire control */
input[type="checkbox"] { appearance: none; /* 20+ lines of custom styles */ }
/* MODERN: accent-color */
input[type="checkbox"],
input[type="radio"] {
accent-color: #7c3aed;
}
Perceptually uniform colors — oklch()
/* OLD: hex/rgb with guess-and-check for each shade */
--brand: #4f46e5;
--brand-light: #818cf8;
--brand-dark: #3730a3;
/* MODERN: oklch — adjust lightness, keep perceived hue */
--brand: oklch(0.55 0.2 264);
--brand-light: oklch(0.75 0.2 264);
--brand-dark: oklch(0.35 0.2 264);
Wide-gamut colors — display-p3 / oklch
/* OLD: sRGB only — washed out on P3 displays */
.hero { color: rgb(200, 80, 50); }
/* MODERN: oklch or display-p3 for vivid colors */
.hero { color: oklch(0.7 0.25 29); }
/* or: color(display-p3 1 0.2 0.1) */
Frosted glass — backdrop-filter
/* OLD: pseudo-element with blurred background image */
.card::before { content: ''; background-image: url(bg.jpg); filter: blur(12px); z-index: -1; }
/* MODERN: backdrop-filter */
.glass {
backdrop-filter: blur(12px);
background: rgba(255, 255, 255, .1);
}
Typography
Fluid typography — clamp()
/* OLD: multiple media queries for each breakpoint */
h1 { font-size: 1rem; }
@media (min-width: 600px) { h1 { font-size: 1.5rem; } }
@media (min-width: 900px) { h1 { font-size: 2rem; } }
/* MODERN: clamp for fluid scaling */
h1 { font-size: clamp(1rem, 2.5vw, 2rem); }
Multiline text truncation — line-clamp
/* OLD: JS to slice text by chars/words and add "..." */
/* MODERN: line-clamp */
.card-title {
display: -webkit-box;
-webkit-line-clamp: 3;
line-clamp: 3;
}
Drop caps — initial-letter
/* OLD: float hack with manual line-height */
.drop-cap::first-letter { float: left; font-size: 3em; line-height: 1; }
/* MODERN: initial-letter */
.drop-cap::first-letter { initial-letter: 3; }
Font loading — font-display: swap
/* OLD: invisible text until font loads (FOIT) */
@font-face { font-family: "MyFont"; src: url(...); }
/* MODERN: font-display swap shows fallback immediately */
@font-face {
font-family: "MyFont";
src: url("MyFont.woff2");
font-display: swap;
}
Variable fonts — single file, all weights
/* OLD: separate @font-face for each weight */
@font-face { font-weight: 400; src: url("Regular.woff2"); }
@font-face { font-weight: 700; src: url("Bold.woff2"); }
/* MODERN: one variable font file */
@font-face {
font-family: "MyVar";
src: url("MyVar.woff2");
font-weight: 100 900;
}
Animation
Independent transforms
/* OLD: rewrite entire transform shorthand to change one value */
.icon { transform: translateX(10px) rotate(45deg) scale(1.2); }
/* MODERN: individual transform properties */
.icon {
translate: 10px 0;
rotate: 45deg;
scale: 1.2;
}
/* animate any one without touching the rest */
Typed custom properties — @property
/* OLD: custom properties are strings, can't animate */
:root { --hue: 0; }
.wheel { transition: --hue .3s; } /* ignored */
/* MODERN: @property makes them animatable */
@property --hue {
syntax: "";
inherits: false;
initial-value: 0deg;
}
.wheel {
background: hsl(var(--hue), 80%, 50%);
transition: --hue .3s;
}
Responsive clip paths — shape()
/* OLD: clip-path: path() uses fixed px coordinates */
.shape { clip-path: path('M0 200 L100 0...'); }
/* MODERN: shape() uses responsive units */
.shape { clip-path: shape(from 0% 100%, ...); }
Workflow
CSS nesting — no preprocessor needed
/* OLD: requires Sass/Less compiler */
// .nav { & a { color: #888; } }
/* MODERN: native CSS nesting */
.nav {
& a { color: #888; }
}
/* plain .css file, no build step */
Cascade layers — @layer
/* OLD: specificity wars and !important */
.page .card .title.special { color: red !important; }
/* MODERN: cascade layers control order */
@layer base, components, utilities;
@layer utilities {
.mt-4 { margin-top: 1rem; }
}
Theme variables — custom properties
/* OLD: Sass variables compile to static values */
$primary: #7c3aed;
.btn { background: $primary; }
/* MODERN: CSS custom properties update at runtime */
:root { --primary: #7c3aed; }
.btn { background: var(--primary); }
Dark mode defaults — color-scheme
/* OLD: manually restyle every form control for dark mode */
@media (prefers-color-scheme: dark) { input, select, textarea { ... } }
/* MODERN: color-scheme tells the browser to handle it */
:root { color-scheme: light dark; }
Lazy rendering — content-visibility
/* OLD: IntersectionObserver to defer rendering */
// new IntersectionObserver((entries) => { /* render */ }).observe(el)
/* MODERN: content-visibility auto */
.section {
content-visibility: auto;
contain-intrinsic-size: auto 500px;
}
Newly Available (80–90% support) — Suggest to User
These techniques are newly available across major browsers. Suggest them to the user, mention the support level, and offer a fallback if needed.
Layout
Dropdown menus — [popover] (86%)
/* OLD: display:none + JS toggle + click-outside + ESC */
.menu { display: none; }
.menu.open { display: block; }
/* MODERN: popover attribute */
/* Toggle */
/* ... */
#menu[popover] { position: absolute; }
Subgrid — align nested grids to parent tracks (88%)
/* OLD: duplicate parent track definitions in child */
.child-grid { grid-template-columns: 1fr 1fr 1fr; }
/* MODERN: subgrid inherits parent tracks */
.child-grid {
display: grid;
grid-template-columns: subgrid;
}
Customizable selects — appearance: base-select (86%)
/* OLD: Select2 or Choices.js replacing native select */
/* MODERN: base-select unlocks full styling */
select, select ::picker(select) {
appearance: base-select;
}
Note: support is expanding rapidly — verify current status on caniuse. Reference →
Hover tooltips — popover=hint + interestfor (86%)
Hover me
Tooltip content
Animation
Entry animations — @starting-style (85%)
/* OLD: requestAnimationFrame to add class after paint */
// requestAnimationFrame(() => el.classList.add('visible'))
/* MODERN: @starting-style defines entry state */
.card {
transition: opacity .3s, transform .3s;
@starting-style {
opacity: 0;
transform: translateY(10px);
}
}
Animating display: none — transition-behavior: allow-discrete (85%)
/* OLD: wait for transitionend, use visibility + opacity + pointer-events */
/* MODERN: allow-discrete enables display transitions */
.panel {
transition: opacity .2s, display .2s;
transition-behavior: allow-discrete;
}
.panel.hidden { opacity: 0; display: none; }
Page transitions — View Transitions API (89%)
/* OLD: Barba.js or React Transition Group */
/* MODERN: View Transitions API */
/*
…
## Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- **Author:** [caidanw](https://github.com/caidanw)
- **Source:** [caidanw/skills](https://github.com/caidanw/skills)
- **License:** MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.