Artifact verification

SkillFiles & storage

Verify an artifact before delivering it - file deliverables (pdf, pptx, docx, xlsx, csv) and web artifacts alike. Use whenever a build is about to return a link, or a build task asks for validation, QA, or a visual check. Covers the per-kind gate scripts, render-and-look verification, and leftover-placeholder scanning.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Artifact verification skill

What this skill tells your AI

The instructions your AI receives, as published by win4r/museai-skills in opt/hatch/skills/artifacts/testing/SKILL.md and read by ahel’s review.

One home for verification across the artifact namespace. The rule every kind shares: a deliverable is verified by looking at what the user will see, freshly rendered, not by trusting the code that produced it. Never return a link while a gate below fails; after three failed fix attempts, report the specific failure and ask for direction instead of iterating.

File kinds: gates, then eyes

KindGate
pdfrender_audit.mjs with the flags the pdf skill's workflow.md names, then /opt/hatch/skills/artifacts/scripts/validate_pdf.sh
presentationassemble_deck.mjs, then render_audit.mjs with the flags workflow.md names
docxrender to PDF with headless LibreOffice (soffice --headless --convert-to pdf), then rasterize (pdftoppm -jpeg -r 100)
xlsx/opt/hatch/skills/artifacts/scripts/validate_xlsx.py
csv / mdparse it back (csv: a Python csv read; md: read the file)

The shared render engine is /opt/hatch/skills/artifacts/scripts/render_audit.mjs; renders outlast muse.exec's default yield, so size yield_ms past the expected runtime and read the report file the flags name rather than trusting a backgrounded command's silence.

Then look. Read every validation PNG or page image with fresh eyes - the generating context sees what it expects, not what rendered. Check first for text overflow or cut-off content, then overlaps, collisions, cramped or uneven spacing, low-contrast text, and template decoration left behind.

Placeholder scan. Before returning, search the deliverable's text for leftover scaffolding: TODO, lorem, placeholder, [insert, xxx runs, and sample rows the user never asked for. Anything found is fixed, not shipped.

Web artifacts

Web builds keep their own audit tools (web_artifacts.build and web_artifacts.audit run the same capture engine with enforcement); this skill's render-fresh and placeholder rules apply to their output all the same.

Signals

GitHub stars
293
Forks
93
Last commit
Sep 2026
Advanced
Item type
skill
Key
artifact-testing
Source
github.com/win4r/museai-skills