# Validate HTML Structure Before Publishing

AI-generated HTML often misses required structure and breaks downstream publishing. This skill checks HTML5 structure and records clear validation results.

## Install

```bash
npx skillstore add abejitsu/html-structure-validate
```

## Metadata

- Status: approved
- Slug: abejitsu-html-structure-validate
- Skillstore revision: r1
- Version status: missing
- Tree hash: 3eeccd748dc0b340dd9aa4568c4944d25ff67ddeb629492e55e83531f9abb496
- Author: AbeJitsu
- GitHub username: AbeJitsu
- License: MIT
- Repository: https://github.com/AbeJitsu/Game-Settings-Panel/tree/main/.claude/skills/calypso/html-structure-validate
- Ref: 9f22d902a4190b1e33cced8a68441beb8e612f59
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/abejitsu-html-structure-validate
- Manifest: https://skillstore.pages.dev/api/skills/abejitsu-html-structure-validate/manifest

## Capabilities

- Checks required HTML5 elements, including doctype, html, head, body, title, stylesheet, and main container.
- Validates tag closure, nesting, headings, lists, image tags, links, and tables.
- Separates blocking structural errors from non-blocking warnings.
- Produces a validation report with status, counts, check results, errors, warnings, and summary metrics.
- Stops the pipeline on structural failures through exit codes and hook workflow guidance.
- Supports strict mode where warnings can fail validation.

## Use Cases

- Validate generated web pages: Check AI-generated HTML pages before they move into consolidation, review, or publishing steps.
- Enforce publishing quality gates: Stop a chapter or page pipeline when required HTML structure is missing or malformed.
- Create repeatable QA reports: Record pass, fail, warning, and summary details for each generated page under review.

## Prompt Templates

### Validate One Page

```
Validate the generated HTML file at [path]. Check structure, required tags, and tag closure. Summarize errors and warnings clearly.
```

### Review Failed Structure Check

```
Review the structure validation result for [page]. Explain each blocking error, likely cause, and the smallest safe HTML fix.
```

### Run Strict Quality Gate

```
Run structure validation for [chapter] in strict mode. Treat warnings as failures and prepare a concise gate decision.
```

### Integrate Validation Workflow

```
Design a structure validation step for the generated HTML pipeline. Include inputs, report location, failure behavior, and retry guidance.
```

## Limitations

- It depends on an existing validate\_html.py tool that is not included in this skill.
- It focuses on structure, not visual rendering, accessibility, or semantic correctness.
- It uses project-specific page paths and CSS container conventions from the Calypso pipeline.
- It does not verify that external links or image files are reachable.

## Best Practices

- Run this validation immediately after HTML generation and before semantic review.
- Keep the validator script versioned with the project that uses this skill.
- Treat errors as blockers and review warnings before final publishing.

## Anti Patterns

- Do not treat successful browser rendering as proof of valid structure.
- Do not suppress failed validation without saving a report and reviewing the root cause.
- Do not reuse project-specific class checks in unrelated templates without updating the rules.

## Security Audit

- Audited at: 2026-07-07T20:29:02.677\+00:00
- Summary: The static alerts are false positives from Markdown inline code, fenced examples, sample HTML, and project-relative paths. No prompt injection, credential access, network activity, malicious filesystem intent, or hidden command execution was found in SKILL.md.

## Stats

- Views: 277
- Downloads: 11
- Favorites: 0
- Popularity score: 0