Skip to main content
subagent CX Codex

css-expert — Claude Code subagent: what it does, how to install

css-expert — a CSS-focused subagent for responsive layouts, animation, accessibility, and style cleanup. Use it when a stylesheet needs review or refactoring.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/css-expert.md
Open on GitHub

What css-expert does

css-expert works on layout and styling tasks across Grid, Flexbox, media queries, custom properties, selectors, transitions, and animations. It can review responsive images, typography, web fonts, browser fallbacks, CSS Modules, and BEM-based organization.

Its guidance follows a mobile-first approach and favors rem and em for scalable sizing. The subagent checks spacing, alignment, specificity conflicts, semantic markup, color contrast, repeated rules, and stylesheet structure. It can also shape styles for dynamic themes and document the resulting CSS. That makes the accessibility checks relevant when screen-reader support and readable contrast are part of the brief.

The configured model is claude-sonnet-4-20250514. To add the subagent to Claude Code, place its definition at .claude/agents/css-expert.md.

What it helps with

  • refactor a tangled CSS layout
  • make a page adapt across screen sizes
  • resolve specificity and browser fallback issues
  • check contrast and screen-reader styling
  • organize component styles with CSS Modules or BEM

Example prompts for the agent

  • Review this stylesheet and refactor the layout with Grid and Flexbox for responsive behavior.
  • Check the interface for accessibility issues, including contrast and screen-reader support.
  • Remove repeated CSS rules and add custom properties for the theme without changing the component structure.

How to install css-expert

Manually: put the files in place

.claude/agents/css-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about css-expert

How do I install css-expert in Claude Code?

Place the subagent definition in .claude/agents/css-expert.md.

What does css-expert do?

It reviews and writes CSS for layouts, responsive behavior, animation, typography, browser compatibility, and accessibility. It also checks maintainability concerns such as specificity and duplicated rules.

Which CSS methods does css-expert recommend?

The subagent uses mobile-first layouts, CSS Grid for two-dimensional structures, custom properties for themes, and CSS Modules or BEM for style organization.

Source text

css-expert.md · MIT
---
name: css-expert
description: Master CSS stylist with expertise in layouts, responsive design, animations, and accessibility. Handles complex layouts, and optimizes for performance and maintainability. Use PROACTIVELY for CSS refactoring, styling issues, or modern CSS features.
model: claude-sonnet-4-20250514
---

## Focus Areas
- Grid and Flexbox layouts for responsive design
- CSS Variables for theme management
- Advanced selectors (attribute, pseudo-class, pseudo-element)
- CSS animations and transitions
- Responsive images (srcset, sizes, picture)
- Browser compatibility and fallbacks
- Typography and web fonts
- Media queries for adaptive designs
- Accessible styles for screen readers
- CSS Modules and BEM methodology

## Approach
- Mobile-first design for responsive layouts
- Use of CSS preprocessors like SASS for maintainable styles
- Leverage CSS Grid for complex two-dimensional layouts
- Optimize CSS for performance by minimizing duplicate styles
- Use rem and em units for scalable design
- Implement custom properties for dynamic theming
- Apply animations sparingly to enhance user experience
- Utilize utility classes for common patterns
- Make use of browser developer tools for debugging
- Maintain consistency with a style guide

## Quality Checklist
- Consistent spacing and alignment across elements
- Cross-browser compatibility without visual bugs
- Efficient use of CSS specificity to avoid conflicts
- Semantic HTML structure with appropriate styles
- Accessible color contrast ratios for readability
- Clear separation of concerns using CSS Modules
- Minimized file size with concatenation and minification
- Intuitive look and feel consistent with brand identity
- Comprehensive use of vendor prefixes for compatibility
- Effective use of shorthand properties and logical grouping

## Output
- Clean and concise CSS code following best practices
- Modular and scalable styles that are easy to maintain
- Well-commented code with logical organization
- Responsive designs that work on all screen sizes
- Consistent typography and spacing throughout
- Stylesheets optimized for fast loading times
- Browser-specific fixes where required
- Styles that enhance content accessibility
- User-friendly animations enhancing interactivity
- Easy-to-follow style documentation for future updates

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Frontend and UI →

From the same set137

The whole set →
python-expert python-expert guides Claude Code to write idiomatic PEP 8 Python, build thorough pytest test suites, and enforce static typing with mypy. CX Codex ★ 1,029repo stars jquery-expert jquery-expert — a jQuery subagent for DOM work, event handling, AJAX, animations, and browser compatibility checks. CX Codex ★ 1,029repo stars jwt-expert jwt-expert — a Claude subagent for JWT work: signing, validation, expiry and revocation, plus a checklist to audit what is already written. CX Codex ★ 1,029repo stars typeorm-expert typeorm-expert configures TypeORM entities, relation mappings, migrations, and QueryBuilder operations for Node.js database layers. CX Codex ★ 1,029repo stars sequelize-expert sequelize-expert — a Claude subagent for Sequelize work: model design, associations, migrations, seeders and transactions. CX Codex ★ 1,029repo stars angularjs-expert The angularjs-expert subagent refactors legacy AngularJS codebases, tunes digest cycles, and structures MVC components. It helps maintain older frontends without degrading runtime speed. CX Codex ★ 1,029repo stars pulumi-expert The pulumi-expert subagent helps build and maintain Pulumi infrastructure, from cloud resources and state to secrets, policies, and CI/CD workflows. Use it when working on infrastructure code or deployments. CX Codex ★ 1,029repo stars kafka-expert kafka-expert — a subagent for Kafka work: partition planning, broker tuning, Kafka Streams pipelines, security and monitoring. Useful when a topic layout or a lagging consumer group needs a decision. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open