update-ard-port

Installation
SKILL.md

Update the ARD port

Lighthouse vendors a JavaScript port of the upstream ARD conformance tester. When upstream changes, the port must be brought back to 1:1 parity while preserving the Lighthouse-specific adaptations listed in third-party/ard/README.md.

What lives where

Upstream (ards-project/ard-spec) Lighthouse Notes
conformance/bin/conformance-test → validate_manifest and helpers third-party/ard/ard.js ConformanceTester (validate_manifest, run_json_schema_validation, add_error/warning/info), parse_media_type, classify_media_type, format_schema_error. Keep upstream snake_case names and word-for-word message text.
spec/schemas/ard-entry.schema.json third-party/ard/spec/schemas/ard-entry.schema.json Must stay byte-identical to upstream.
(generated) third-party/ard/schema-validator.js Precompiled Ajv standalone validator, built by build/build-ard-schema.js (yarn build-ard-schema). Never hand-edit.
spec/ard.md §5.1 Discovery Mechanisms (+ resolve_publisher in the script) core/gather/gatherers/agentic/ard.js Candidate order: robots.txt agentmap → <link rel="ard"> → Link header → /.well-known/ard.json → legacy ai-catalog equivalents. Source names in Artifacts.ArdDiscoverySource (types/artifacts.d.ts).
severity / scoring (Lighthouse-only) core/audits/agentic/ard-schema.js errors → score 0; warnings/legacy/broken-link → 0.9; clean → 1. infos are not surfaced.
pinned SHA + reviewed hashes + deviation list third-party/ard/README.md **Pinned Commit SHA** and the **Reviewed Upstream Files** SHA-256 lines are parsed/written by the update script. Never edit the hashes by hand — they are the proof that the port was reviewed against that exact upstream content.
Installs
8
GitHub Stars
31.2K
First Seen
Oct 18, 2026