agentsclimarketplace

Html lint runner

Skill naporin0624/claude-web-audit-plugins/skills/html-lint-runner

Runs automated HTML linting using @axe-core/playwright (WCAG accessibility) and markuplint (HTML standards). Use when user asks to "lint HTML", "run automated checks", "validate HTML", "check accessibility", or mentions "axe-core", "markuplint", "automated audit".From its SKILL.md

Install
npx -y skills add naporin0624/claude-web-audit-plugins --skill html-lint-runner

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.4 KB, as published. Nobody here has run it

HTML Lint Runner

Automated HTML linting using @axe-core/playwright and markuplint with JSON output.

Tools Overview

ToolFocusOutput
@axe-core/playwrightWCAG 2.1 AA accessibilityJSON with violations
markuplintHTML standards, semanticsJSON with problems

Quick Start

# Install dependencies
cd ${CLAUDE_PLUGIN_ROOT}/skills/html-lint-runner && npm install

# Run combined lint (development)
npm --prefix ${CLAUDE_PLUGIN_ROOT}/skills/html-lint-runner run dev -- path/to/file.html

# Run with build
npm --prefix ${CLAUDE_PLUGIN_ROOT}/skills/html-lint-runner run build
node ${CLAUDE_PLUGIN_ROOT}/skills/html-lint-runner/dist/index.js path/to/file.html

Options

OptionDescription
--jsonOutput as JSON (default)
--textOutput as human-readable text
--axe-onlyRun only axe-core (accessibility)
--markuplint-onlyRun only markuplint (HTML standards)

Supported File Types

Extensionaxe-coremarkuplintNotes
.htmlYesYesFull support
.htmYesYesFull support
.jsxNo*Yesmarkuplint only
.tsxNo*Yesmarkuplint only

*JSX/TSX require rendering to HTML for axe-core analysis

Output Structure

{
  "file": "target.html",
  "timestamp": "2025-01-01T00:00:00Z",
  "axe": {
    "violations": [...],
    "passes": [...],
    "incomplete": [...]
  },
  "markuplint": {
    "problems": [...]
  },
  "summary": {
    "axe_violations": 3,
    "markuplint_problems": 5,
    "total_issues": 8
  }
}

axe-core Violations

{
  "id": "color-contrast",
  "impact": "serious",
  "description": "Elements must have sufficient color contrast",
  "nodes": [
    {
      "html": "<p class=\"light\">...</p>",
      "failureSummary": "Fix: Increase contrast ratio to 4.5:1"
    }
  ]
}

Impact levels: critical > serious > moderate > minor

markuplint Problems

{
  "severity": "error",
  "ruleId": "required-attr",
  "message": "The \"alt\" attribute is required",
  "line": 15,
  "col": 5,
  "raw": "<img src=\"photo.jpg\">"
}

Workflow

  1. Run combined lint - Check both accessibility and HTML standards
  2. Parse JSON results - Identify issues by severity
  3. Prioritize issues - critical > serious > error > warning
  4. Apply fixes - Address high-priority issues first
  5. Re-run to verify - Confirm fixes resolved issues

Common Fixes

Missing alt text

<!-- Before -->
<img src="photo.jpg">

<!-- After -->
<img src="photo.jpg" alt="Description of image">

Low contrast

/* Before: #999 on #fff = 2.85:1 */
.text { color: #999; }

/* After: #595959 on #fff = 7:1 */
.text { color: #595959; }

References

Keep looking

Skills are one crate of 609,856. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.