ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

ua1-validator-agent

Validate PDFs against PDF/UA-1 using ua1.dev or api.ua1.dev from AI coding agents (OpenClaw, Claude Code, Codex, OpenCode). Use when an agent needs deterministic accessibility checks, compact machine-readable verdicts, CI gating, or structured remediation loops for PDF files.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/hajekt2/ua1-validator-agent
Or

UA1 Validator Agent Skill

Use this skill to run deterministic PDF/UA-1 checks from an agent workflow.

Endpoints

  • Health: GET https://api.ua1.dev/api/health
  • Validate: POST https://api.ua1.dev/api/validate
  • Compact mode: POST https://api.ua1.dev/api/validate?format=compact
  • Metrics: GET https://api.ua1.dev/api/metrics

Required contract

Send multipart form-data with field name file.

  • Accepted: .pdf
  • Typical outcomes:
    • 200 validation response
    • 415 unsupported type
    • 413 file too large
    • 429 rate-limited

Minimal workflow for agents

  1. Run health check once before batch validation.
  2. Validate each PDF using compact mode for deterministic parsing.
  3. If verdict is fail, capture findings and group by rule_id.
  4. Produce remediation plan sorted by rule frequency.
  5. Re-run validation after fixes and compare counts.

Use script

Run:

bash scripts/validate_pdf.sh /absolute/or/relative/path/to/file.pdf

Optional env:

  • UA1_API_BASE (default: https://api.ua1.dev)
  • UA1_FORMAT (compact by default; set full for full payload)

CI gate pattern

Treat non-pass verdict as a failed quality gate.

  • Exit 0 only when verdict is pass
  • Exit 2 when verdict is fail
  • Exit 1 for transport/API errors

Use the script’s exit codes directly in pipelines.

Metadata

Author@hajekt2
Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-hajekt2-ua1-validator-agent": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.