skills.rest
jokerman89
jokerman89COMMUNITY
Explore all skills by this author →
WebsiteGitHub

generate-qa

Validates generated artifacts against brand, voice, readability, and structure standards with auto-fixes.

Updated May 27, 2026
Search Tags:#validation#qa#readability#auto-fix#pptx#docx#brand compliance
One-click install
npx skills add https://github.com/jokerman89/lintel --skill generate-qa-jokerman89
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-qa
Source: https://github.com/jokerman89/lintel/tree/main/skills/generate-qa
Command: npx skills add https://github.com/jokerman89/lintel --skill generate-qa-jokerman89

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, python-docx, beautifulsoup4, pdfplumber.

What problem does it solve? Generated documents and decks often ship with brand inconsistencies, readability issues, and off-voice wording that require tedious manual review. This Skill automates quality assurance on artifacts like PPTX, DOCX, HTML, PDF, and XLSX files, catching errors before they reach customers. ## Core Features & Use Cases - Multi-format validation: Runs brand, readability, voice, and structure checks on PPTX, DOCX, HTML, PDF, XLSX, and Visio artifacts, whether or not they came from the generate pipeline. - Tiered auto-fix modes: Applies safe fixes (font resizing, blocklist word replacement, empty placeholder removal) by default, with aggressive and report-only modes available. - Structured QA reporting: Produces a qa-report.json with severity-tagged issues, fix records, and a pass/fail summary. - Use Case: Before forwarding a deck a teammate sent you, run QA to verify brand colors, font sizes, bullet limits, and vocabulary blocklist compliance, then review the severity-tagged report. ## Quick Start Ask the agent to run generate-qa on your artifact, for example: validate the deck at output/pitch.pptx against the default palette and voice blocklist with safe auto-fixes.

Frequently Asked Questions about generate-qa

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

FAQPage Schema
How do I validate a PowerPoint deck against brand guidelines automatically?▼

Run generate-qa with the --artifacts flag pointing to your PPTX file. It checks colors, fonts, logo placement, readability, and voice rules, then writes a qa-report.json with severity-tagged issues and applies safe auto-fixes by default.

What file formats does generate-qa support for QA checks?▼

It supports PPTX, DOCX, HTML, PDF, XLSX, and Visio source files. Format-specific tools like python-pptx, python-docx, BeautifulSoup, and pdfplumber handle extraction, with reduced coverage possible for XLSX and Visio.

Can I run QA on documents not produced by the generate pipeline?▼

Yes, generate-qa is solo-invokable on any artifact, including decks from teammates or legacy DOCX files. The design-spec input is optional and only used for cross-reference checks when available.

What is the difference between safe and aggressive auto-fix modes?▼

Safe mode replaces blocklist words, resizes undersized fonts, strips empty placeholders, and normalizes bullet markers. Aggressive mode additionally truncates long bullets, reorders duplicate-titled slides, and adjusts text contrast, with all changes flagged in the report.

When should I not use generate-qa for content review?▼

Do not use it as the customer-share voice-gate, which is handled by the active pack's compliance hooks, or for design-doc-level review, which belongs to plan-design-review. QA is broader but advisory for voice-tier decisions.

Related Skills

Explore More Content & Communication Skills→
TravisLeeeeeeTravisLeeeeee
110

Document Generator

Generate PDF, PPTX, XLSX, and DOCX documents from structured data.

Community
Intermediate
easonlaoeasonlao

smoke-check

Run automated tests and interactive smoke checks into a PASS/FAIL report.

Community
Advanced
kanyun-inckanyun-inc
58

skill-sync-checker

Detect content drift between AI skill files and source documents via markers.

Official
Intermediate
markuplintmarkuplint
611

grill-me

Interrogates plans and designs through sequential questions with recommended answers.

Official
Basic