Skip to main content
subagent CX Codex

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

html-expert — a subagent that builds semantic, accessible markup aligned with WCAG rules. It cleans up document structure, meta tags, and form elements.

MIT ★ 1,029 updated 2025-10-15

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

What html-expert does

This subagent handles HTML markup inside Claude Code. It enforces proper heading hierarchy, verifies tag nesting, requires the lang attribute on the root element, and runs validation checks. Layout markup is kept separate from tabular data, so tables cannot be used for page scaffolding.

Accessibility and search discovery drive the output. The subagent attaches descriptive alt text to images, injects ARIA roles where needed, and structures forms with required accessibility properties. Video and audio tags receive fallback content for unsupported browsers. Visual styling is delegated to CSS stylesheets, which means inline styles are removed from the markup.

What it helps with

  • validate document structure against markup standards
  • organize headings into a logical hierarchy
  • configure accessible forms and multimedia fallbacks
  • strip inline styling in favor of external stylesheets
  • insert metadata and tags for search discovery

Example prompts for the agent

  • Review markup semantics in index.html with html-expert
  • Update the login form to satisfy WCAG accessibility criteria
  • Fix heading hierarchy and add descriptive image alt tags

How to install html-expert

Manually: put the files in place

.claude/agents/html-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 html-expert

How to install html-expert in Claude Code?

Save the subagent configuration file at .claude/agents/html-expert.md. Claude Code will automatically reference it when working with markup.

What does html-expert do?

It audits and generates semantic markup, enforces accessibility requirements, and ensures proper tag nesting. It also prevents using tables for page layouts.

How does the subagent handle visual presentation?

It forbids inline style attributes in markup. All visual presentation must live inside separate CSS stylesheets.

Source text

html-expert.md · MIT
---
name: html-expert
description: Expert in HTML structure, semantics, and best practices for building clean, accessible, and optimized web pages.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Understanding semantic HTML and its importance
- Structuring documents with proper use of headings
- Creating accessible HTML for screen readers
- Implementing HTML5 elements effectively
- Validating HTML to ensure compliance with standards
- Enhancing SEO through HTML structure and tags
- Utilizing ARIA roles appropriately
- Embedding multimedia elements like video and audio
- Form creation and handling with HTML
- Managing links and navigation within HTML documents

## Approach

- Write semantic HTML to improve accessibility
- Use proper indentation and formatting for readability
- Ensure all HTML documents validate using a validator
- Adapt HTML5 elements for better semantics
- Always use meaningful alt attributes for images
- Apply appropriate ARIA roles where necessary
- Avoid inline styles; use CSS for presentation
- Optimize HTML for SEO with meta tags and headers
- Use tables for tabular data only, not for layout
- Test HTML structure across various browsers

## Quality Checklist

- All HTML documents pass validation tests
- Proper use of DOCTYPE declaration
- Ensure correct nesting and closing of tags
- Use of lang attribute on the HTML tag
- All links are functional and have descriptive text
- Images include descriptive alt text
- Forms include necessary attributes for accessibility
- Headers are used in a logical order without skipping
- Use proper escaping for special characters
- Review for semantic accuracy and best practices

## Output

- HTML files with clean, semantic markup
- Accessible web pages compliant with WCAG standards
- SEO-optimized structure with proper use of tags
- Cross-browser tested for compatibility
- Descriptive and functional navigation elements
- Well-structured forms with necessary attributes
- Embedded media with fallbacks for unsupported browsers
- Correct use of HTML5 semantic elements
- Consistent areas for layout and content
- Documentation with examples and code snippets for clarity

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

Similar subagents

All subagents for Frontend and UI →

From the same set137

The whole set →
fiber-expert fiber-expert — a Claude subagent for fiber work: natural and synthetic types, manufacturing, textile uses and market trends. Built for industry questions rather than code. CX Codex ★ 1,029repo stars opentelemetry-expert opentelemetry-expert configures OpenTelemetry tracing, metrics, and logs while handling context propagation and sampling strategies. CX Codex ★ 1,029repo stars liquibase-expert The liquibase-expert subagent helps manage Liquibase schema changes, validate changeSets, and prepare rollbacks. Use it when working on database migrations. CX Codex ★ 1,029repo stars flyway-expert flyway-expert — a subagent that handles Flyway database migrations: versioning scripts, checking them before production, keeping a rollback plan ready. Useful once migrations pile up. CX Codex ★ 1,029repo stars actix-expert actix-expert — a Claude Code subagent for Actix and Rust web work, covering routes, middleware, errors, tests, and performance checks. CX Codex ★ 1,029repo stars elixir-expert elixir-expert — an Elixir-focused subagent for Claude: pattern matching, supervision trees, GenServers, Phoenix channels and ExUnit tests, with Dialyzer in the checklist. CX Codex ★ 1,029repo stars grafana-expert grafana-expert designs Grafana dashboards, configures alert rules, and optimizes queries for metrics backends. CX Codex ★ 1,029repo stars opensearch-expert The opensearch-expert subagent helps configure OpenSearch clusters, indexes, and queries. Call on it when working through scaling, security, or performance issues. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open