html
"Semantic HTML with proper elements and structure. Trigger: When writing HTML markup, creating structure, or implementing semantic elements."
Install
npx skillscat add joabgonzalez/ai-agents-skills/html Install via the SkillsCat registry.
HTML Skill
Semantic, accessible HTML with modern standards, proper structure, meta tags.
When to Use
Use when:
- Writing HTML markup for web pages
- Creating document structure with semantic elements
- Building forms with proper labels and inputs
- Adding metadata and head elements
Don't use for React JSX (react skill) or accessibility details (a11y skill).
Critical Patterns
✅ REQUIRED: Semantic Elements
<!-- CORRECT -->
<header>
<nav>
<ul>
<li><a href="/">Home</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h1>Title</h1>
<p>Content</p>
</article>
</main>
<footer>Footer content</footer>
<!-- WRONG: generic divs -->
<div class="header">
<div class="nav">...</div>
</div>
<div class="main">...</div>✅ REQUIRED: Proper Heading Hierarchy
<!-- CORRECT: sequential -->
<h1>Page Title</h1>
<h2>Section</h2>
<h3>Subsection</h3>
<!-- WRONG: skipping levels -->
<h1>Page Title</h1>
<h4>Section</h4>✅ REQUIRED: Button vs Anchor
<!-- CORRECT: button for actions -->
<button type="button" onclick="doSomething()">Click</button>
<!-- CORRECT: anchor for navigation -->
<a href="/page">Go to Page</a>
<!-- WRONG: anchor for actions -->
<a href="#" onclick="doSomething()">Click</a>✅ REQUIRED: Essential Meta Tags
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="description" content="Page description for SEO (150-160 chars)" />
<title>Page Title - Site Name</title>
<!-- Open Graph -->
<meta property="og:title" content="Page Title" />
<meta property="og:description" content="Description" />
<meta property="og:image" content="https://example.com/image.jpg" />
<meta property="og:url" content="https://example.com/page" />
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Page Title" />
</head>
<body><!-- Content --></body>
</html>Decision Tree
Interactive element? -> <button> for actions, <a> for navigation.
Text content? -> <article> for standalone content, <section> for grouped content, <aside> for related info.
Form field? -> Wrap in <label>, associate via for/id, use appropriate type.
List of items? -> <ul> unordered, <ol> ordered, <dl> definitions.
Heading? -> <h1>-<h6> sequential; one <h1> per page.
Image? -> <img> with descriptive alt; empty alt="" for decorative.
Tabular data? -> <table> with <thead>, <tbody>, <th scope>.
Example
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Page Title</title>
</head>
<body>
<header>
<nav aria-label="Main navigation">
<ul>
<li><a href="/">Home</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h1>Article Title</h1>
<p>Content</p>
</article>
</main>
</body>
</html>Edge Cases
- Multiple h1: Allowed, but one per page better for screen readers
- Empty links: Use
<button>for actions, not<a href="#"> - Div soup: Prefer semantic elements over
<div> - Form without action: Needs
actionor JS handler - Button type: Default
submit; specifytype="button"for non-submit
Checklist
- Semantic elements (
<nav>,<main>,<article>,<section>) - Sequential heading hierarchy (no skipped levels)
-
<button>for actions,<a>for navigation -
langattribute on<html> - Essential meta tags (charset, viewport, description)
- Open Graph / Twitter Card meta for social sharing
-
alttext on all images - Labels on all form inputs
- Valid nesting (one
<main>, proper structure) - HTML validated against spec
Resources
Categories
Install
npx skillscat add joabgonzalez/ai-agents-skills/html Install via the SkillsCat registry.