TheGoat395/Codex-Skills / skills/css-grid-editorial-systems
css-grid-editorial-systems
VerifiedImplement asymmetric editorial CSS Grid layouts.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 681 B |
| agents/openai.yaml | config | 250 B |
| references/css-grid-editorial-systems-guide.md | markdown | 3.2 KB |
references/css-grid-editorial-systems-guide.md
View on GitHub# CSS Grid Editorial Systems Guide
## Purpose
Use grid to create hierarchy, rhythm, and editorial taste instead of default equal cards.
## Use When
- A page needs a premium layout with varied scale, media, and content hierarchy.
- A generic card grid should become an editorial or product-proof composition.
- Galleries, portfolios, case studies, homepage sections, or feature narratives need stronger structure.
## Do Not Use When
- A simple one-dimensional alignment problem is better solved with flexbox.
- The content is tabular and should use a table or data grid.
- The existing design system already prescribes grid behavior.
## Discovery Questions
- What is the visual hierarchy: lead item, secondary items, supporting proof, or archive?
- What grid constraints exist: columns, gutters, max width, baseline rhythm, media aspect ratios?
- Should the layout be symmetric, asymmetric, dense, spacious, editorial, or operational?
- How should the grid collapse on mobile without becoming a bland stack?
## Decision Tree
- Define content roles before grid tracks.
- Use explicit grid tracks for major composition and auto-placement for repeated minor items.
- Use aspect-ratio and object-fit for stable media plates.
- Vary scale intentionally: one lead moment, a few supporting pieces, and calm spacing.
- Create a mobile order that preserves narrative priority.
## Implementation Rules
- Do not use equal cards when the content has unequal importance.
- Keep gutters and alignment consistent even in asymmetry.
- Avoid layout tricks that break reading order or keyboard order.
- Use grid areas or named classes when the composition is complex enough.
- Make image crops and captions part of the grid system.
## Useful Patterns
- Portfolio: one oversized feature, two medium works, compact archive strip.
- Luxury editorial: full-bleed media band, offset text column, restrained supporting grid.
- Product proof: large UI screenshot, adjacent metric/code/details, integration row.
- Case study: artifact plates with alternating span and caption behavior.
## Anti-Patterns
- Three identical cards under every heading.
- Masonry-like layouts that create chaotic reading order.
- Grid spans chosen randomly for visual noise.
- Desktop-only editorial grid with broken mobile order.
## QA Checklist
- Inspect reading order, tab order, and mobile order.
- Check all media aspect ratios and crops.
- Verify grid does not overflow at mid-widths.
- Compare the result against the section's hierarchy goals.
## Acceptance Criteria
- The grid communicates content priority clearly.
- The layout feels authored and site-specific.
- Mobile keeps the editorial rhythm instead of collapsing into generic cards.
## Scoped execution
Apply the [shared web contract](../../website-operating-rules/references/scoped-web-contract.md) once when execution crosses phases; reuse it if already read. Load only the specialist guidance relevant to the requested surface and deliverable.
## Official Source Anchors
- MDN CSS grid layout: https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Grid_layout
- Tailwind utility classes: https://tailwindcss.com/docs/styling-with-utility-classes
- Tailwind responsive design: https://tailwindcss.com/docs/responsive-design
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 |