mira-validator

Validates generated slide deck HTML files against visual, structural, and asset compliance rules.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/mayconspirlandelli/slides-podcast-ia-home-office --skill mira-validator-mayconspirlandelli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mira-validator
Source: https://github.com/mayconspirlandelli/slides-podcast-ia-home-office/tree/main/.agents/skills/mira-validator
Command: npx skills add https://github.com/mayconspirlandelli/slides-podcast-ia-home-office --skill mira-validator-mayconspirlandelli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually reviewing generated slide deck HTML for design-system compliance is slow and error-prone. This Skill automates the inspection of index.html files produced by the mira-builder workflow, catching color deviations, missing assets, broken structure, and leftover placeholders before publication. ## Core Features & Use Cases - Compliance Checklist: Runs 30+ checks across nine categories covering colors, visual identity, videos, card layout, typography, navigation, content composition, assets, and code escaping. - Severity-Graded Report: Produces a structured report classifying findings as critical, important, or quality suggestions, with exact line numbers and correction instructions for each failure. - Automatic Fixes: Offers to apply targeted edits to the HTML for critical and important failures, then re-runs validation to confirm. - Use Case: After mira-builder generates a deck at decks/<deck>/index.html, run this validator to confirm the primary color #FF904D is used, the logo and header video files exist, and no placeholders like [TITULO] remain. ## Quick Start Validate the slide deck at decks/chapter-1/index.html and show me the full compliance report.

Frequently Asked Questions about mira-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate an HTML slide deck against a design system?▼

Point the validator at the deck's index.html file and it runs a checklist covering colors, identity assets, videos, layout, typography, and structure. It returns a report with PASS or FAIL per check, line numbers, and specific correction instructions.

What checks does the slide HTML validation cover?▼

The checklist spans nine categories: colors, visual identity, videos, card layout, typography, structure and navigation, content composition, chapter assets, and code escaping. Each check specifies exact patterns to search for, such as #FF904D for the primary color or backdrop-filter blur for glassmorphism.

Can the validator fix HTML compliance issues automatically?▼

Yes. After generating the report, it offers to correct critical and important failures with targeted edits to the index.html file, then re-runs validation to confirm the fixes. It does not modify the textual content of slides, only technical and conformance issues.

Why does slide validation report missing asset failures?▼

Failures occur when files referenced in the HTML, such as canal_sandeco_logo.png or header-bg.mp4, do not exist in the slide folder. The validator checks every img and video source against the actual directory contents to catch broken references before publishing.

When should I run slide deck validation?▼

Run it automatically after mira-builder finishes generating an index.html, or manually whenever you want to review an existing presentation, diagnose visual problems, or verify slides follow the project standard before publishing.