semantic-html

name	semantic-html
description	Semantic HTML5 markup patterns for meaningful, accessible, and SEO-optimized content structure
sasmp_version	1.3.0
bonded_agent	html-expert
bond_type	PRIMARY_BOND
version	2.0.0
category	semantics
complexity	intermediate
dependencies	["html-basics"]
parameters	{"content_type":{"type":"string","required":true,"enum":["article","navigation","sidebar","header","footer","section","figure","list","table"]},"semantic_level":{"type":"string","default":"strict","enum":["strict","moderate","minimal"]},"include_landmarks":{"type":"boolean","default":true}}
retry	{"max_attempts":3,"backoff_ms":[1000,2000,4000],"retryable_errors":["PARSE_ERROR","VALIDATION_ERROR"]}

Semantic HTML Skill

Transform markup from presentation-focused to meaning-focused, enabling accessibility, SEO, and AI/voice interface compatibility.

🎯 Purpose

Provide atomic, single-responsibility operations for:

• Document outline and structure semantics
• Content sectioning (<article>, <section>, <nav>)
• Landmark roles and ARIA mapping
• Microdata and structured data hints
• SEO and accessibility improvements

---

📥 Input Schema

interface SemanticHtmlInput {
  operation: 'analyze' | 'convert' | 'validate' | 'suggest';
  content_type: ContentType;
  markup?: string;           // Existing HTML to analyze/convert
  context?: {
    page_type: 'homepage' | 'article' | 'product' | 'contact' | 'search';
    has_sidebar: boolean;
    has_comments: boolean;
  };
  options?: {
    semantic_level: 'strict' | 'moderate' | 'minimal';
    include_landmarks: boolean;
    preserve_classes: boolean;
  };
}

type ContentType =
  | 'article'     // Blog post, news article
  | 'navigation'  // Nav menus, breadcrumbs
  | 'sidebar'     
  |       
  |       
  |      
  |       
  |         
  | ;