tidy

name	tidy
description	Use this skill when the user wants to check, clean, repair, or convert HTML/XML documents, fix markup errors, or enforce consistent HTML style.

HTML Tidy Plugin

Corrects and cleans up HTML and XML documents. Fixes markup errors, improves layout, enforces consistent style, and converts between HTML versions.

Commands

Checking

• tidy check lint — Check HTML file for errors and warnings (no modifications)
• tidy check errors — Show only errors (no warnings)

Fixing

• tidy fix run — Clean and repair HTML file (output to stdout)
• tidy fix inplace — Clean and repair HTML file in-place (modifies the file)

Conversion

• tidy convert to-xhtml — Convert HTML to XHTML
• tidy convert to-html5 — Convert HTML to HTML5

Configuration

• tidy config show — Show current tidy configuration
• tidy help options — Show all available tidy options

Utility

• tidy self version — Print tidy version

Passthrough

• tidy _ _ — Passthrough to tidy CLI

Usage Examples

• "Check my HTML file for errors"
• "Clean up and fix this HTML file"
• "Convert HTML to XHTML"
• "Show only errors, no warnings"
• "Format HTML with consistent indentation"

Installation

brew install tidy-html5

Or via apt:

sudo apt-get install tidy

Examples

# Check HTML for errors (no modifications)
sc tidy check lint --file index.html

# Show only errors (no warnings)
sc tidy check errors --file index.html

# Clean and repair HTML (output to stdout)
sc tidy fix run --file messy.html

# Clean and repair HTML in-place (modifies file)
sc tidy fix inplace --file index.html

# Convert HTML to XHTML
sc tidy convert to-xhtml --file index.html

# Convert HTML to HTML5
sc tidy convert to-html5 --file legacy.html

# Show current configuration
sc tidy config show

# Passthrough: check with custom indent
sc tidy _ _ -indent --wrap 120 index.html

# Passthrough: clean presentational clutter
sc tidy _ _ --clean --indent index.html

Key Features

• Error checking — Detects and reports HTML markup errors
• Cleaning — Fixes common HTML issues automatically
• Indentation — Consistent indentation and formatting
• HTML version conversion — Convert between HTML4, XHTML, HTML5
• Configurable — Hundreds of configuration options
• XML support — Can process XML documents too
• Non-destructive lint — Check without modifying files
• In-place fix — Modify files directly with -m flag