Block Markup Validator — Development agent for Claude Code
Validates WordPress block comment syntax, JSON attributes, HTML class consistency, heading hierarchy, and theme.json slug references across all templates and patterns.
How to install Block Markup Validator
Installs to ~/.claude/agents/pmdevsolutions-flavian-block-markup-validator.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/PMDevSolutions/Flavian/HEAD/.claude/agents/block-markup-validator.md -o ~/.claude/agents/pmdevsolutions-flavian-block-markup-validator.md Restart Claude Code, or start a new session, for it to be picked up.
What Block Markup Validator does
name: block-markup-validator description: Validates WordPress block comment syntax, JSON attributes, HTML class consistency, heading hierarchy, and theme.json slug references across all templates and patterns. tools: Read, Write, Bash, Grep, Glob, TodoWrite, TaskOutput model: opus permissionMode: bypassPermissions hooks: PreToolUse: - matcher: "Write|Edit" hooks: - type: command command: "./.claude/hooks/validate-theme-location.sh" description: "Blocks
Alternatives in Development
- Workflow Syntax Designer — Specialized agent for creating custom syntax elements when existing syntax is insufficient 214 ★
- Glance — Reports hierarchy only from a capture-bound squint packet 190 ★
- Python Sidecar Specialist — Use for the Python sidecars on both surfaces: the verify checks (syntax, imports, statement mapping, coverage 179 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Accessibility Wcag Auditing Subagent
Sub-agent owning accessibility signals directly verifiable from markup — alt text, heading hierarchy, semantic
Wp Theme Reviewer
Audits a generated or existing WordPress block theme for FSE correctness, theme.json validity, accessibility,
WordPress Roots
Senior WordPress developer on the modern Roots stack (Bedrock, Sage, Acorn, Blade, Tailwind, Vite, Composer).
Wp Reviewer
Reviews WordPress plugin and theme code for handbook compliance and best practices
WordPress Expert
Expert WordPress/PHP developer. Use for WordPress theme development, plugin development, GeneratePress customi
18 Product Schema
Check a product page's Product/Offer/AggregateRating markup and return one corrected JSON-LD block built from
Related Skills
SEO Content Audit
Use when auditing a website's content/markup for on-page SEO basics — title tags, meta descriptions, heading h
SEO Schema
Schema markup expert. Detects, validates, and generates Schema.org structured data in JSON-LD format.
Paper Trail Cascade
Acquire PDFs via the 8-source cascade (11 with opt-in extended sources) for a single ref by slug, or a batch f