presentation-deck-qa
Skill0 starsChanged 24 days agoMITView on GitHub
Finalizes a complete presentation with aligned notes, verified evidence and timing, preview QA, and a fresh export of the chosen delivery format(s). Use when the production-qa gate is current, final downloads are requested, exports changed, or a deck must be proven stage-ready.
In this repository42 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/vercel-composition-patterns/AGENTS.mdAGENTS.md
- .agents/skills/vercel-react-best-practices/AGENTS.mdAGENTS.md
- apple-designSkill
- apply-commentsSkill
- create-slideSkill
- create-themeSkill
- current-slideSkill
- diagram-designSkill
- emil-design-engSkill
- frontend-designSkill
- genofficeSkill
- grillingSkill
- grill-meSkill
- human-writingSkill
- make-presentationSkill
- presentation-evidenceSkill
- presentation-product-grillSkill
- presentation-prototypeSkill
- presentation-source-intakeSkill
- presentation-stage-grillSkill
- presentation-story-architectureSkill
- presentation-story-grillSkill
- review-animationsSkill
- shadcnSkill
- slide-authoringSkill
- to-questionnaireSkill
- vercel-composition-patternsSkill
- vercel-react-best-practicesSkill
- wait-whatSkill
- wang-yongfu-teaching-craftSkill
- web-design-guidelinesSkill
- genofficeSkill
- make-presentationSkill
- presentation-deck-qaSkill
- presentation-evidenceSkill
- presentation-product-grillSkill
- presentation-prototypeSkill
- presentation-source-intakeSkill
- presentation-stage-grillSkill
- presentation-story-architectureSkill
- presentation-story-grillSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
23 rules. About 0 are common, 9 are distinctive, and 14 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
14
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use when production-qa is the current gate or when a deck needs final delivery.
- Very specific: line 14
Read the engine from the status tracker via node .agents/skills/make-presentation/scripts/status.mjs next <work-root> (the JSON block in …
- Very specific: line 15
If no engine is recorded anywhere, ask the user now, one question, with a recommended default (see .agents/adapters/: open-slide, …
- Very specific: line 16
Read .agents/adapters/<engine>/qa.md (or adapters/<engine>/qa.md) for that engine's preview surface, export command, export format(s), and …
- Very specific: line 20
Use pipeline mode when presentation-work/<deck-id>/ exists.
- Very specific: line 21
Use standalone mode when pipeline artifacts and STATUS.md are absent.
- Very specific: line 23
Do not create a pipeline work area solely for finalization.
- Very specific: line 27
Read repo instructions, the full deck, notes, and unresolved QA risks.
- Distinctive: line 28
Check visible claims, notes, timing, and delivery wording for consistency with the approved brief, evidence ledger, story, and script.
- Distinctive: line 32
Check factual consistency across slides, notes, references, and exports.
- Very specific: line 33
Run node .agents/skills/make-presentation/scripts/unslop-check.mjs <slide-folder-or-notes> --strict.
- Distinctive: line 40
Run the relevant repo checks and target build.
- Very specific: line 45
Verify compliance with the declared Visual Direction & Rendering DNA in PRESENTATION-BRIEF.md.
- Distinctive: line 46
Verify typography hierarchy (Hero titles reach 120px+, section headers 72px+, prominent display scale).
- Very specific: line 47
If Sticker Pop / Sketch archetype was declared, verify all cards carry 3px ink borders and hard offset shadows (8px 8px 0px), not generic …
- Distinctive: line 48
Verify visual diagram craft (SVGs match the aesthetic DNA, no raw generic boxes).
- Distinctive: line 49
Treat clipping, unreadable type, generic AI slop styling, inconsistent page grammar, or notes drift as failed QA.
- Distinctive: line 53
After deck or exporter changes, produce a fresh export in each chosen delivery format.
- Very specific: line 54
Unified Export: Run node .agents/skills/make-presentation/scripts/export-deck.mjs <deck-id> --format=pdf,pptx (or npx open-slide export …
- Very specific: line 55
Automated QA Audit Pipeline: Run node .agents/skills/make-presentation/scripts/qa-deck.mjs <deck-id> --export (or npx open-slide qa …
- Very specific: line 56
Follow adapters/<engine>/qa.md for the engine's export steps, archive integrity, geometry, and any native-application inspection.
- Distinctive: line 57
Visual-Faithful Verification: Verify that the exported PPTX preserves visual layout without text box re-wrapping or bounding-box drift when …
- Distinctive: line 59
If the preview and any export disagree, the export is not complete.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Finalize the deck for delivery
Use when production-qa is the current gate or when a deck needs final delivery. Author to the engine's technical rules (from its adapter).
Engine
This gate renders and exports, so it needs the slide engine chosen at the prototype gate. Resolve it before QA:
- Read the engine from the status tracker via
node .agents/skills/make-presentation/scripts/status.mjs next <work-root>(the JSON block inSTATUS.mdcarries anenginefield set at the prototype gate). Fall back to the## Engineline inPRESENTATION-BRIEF.mdif the tracker has no engine recorded. - If no engine is recorded anywhere, ask the user now, one question, with a recommended default (see
.agents/adapters/:open-slide,genoffice,marp,pptxgenjs; the bundled reference adapter isopen-slide, orgenofficefor native byte-preserving Office.pptx). - Read
.agents/adapters/<engine>/qa.md(oradapters/<engine>/qa.md) for that engine's preview surface, export command, export format(s), and inspection steps. The sections below are the engine-agnostic backbone; the adapter supplies the engine-specific surface and exports.
Choose context
- Use pipeline mode when
presentation-work/<deck-id>/exists. Validate its status with the shipped helper. Read the current mode fromSTATUS.md. - Use standalone mode when pipeline artifacts and
STATUS.mdare absent. - In standalone mode, derive a minimal QA context from the deck and notes: purpose, likely audience, material claims, main/backup range, timing assumptions, and unresolved risks.
- Do not create a pipeline work area solely for finalization; only create or update
STATUS.mdwhen a pipeline work area exists.
Align content
- Read repo instructions, the full deck, notes, and unresolved QA risks. In pipeline mode also read available
PRESENTATION-BRIEF.md,EVIDENCE-LEDGER.md,STORY.md,STORYBOARD.md,GRILL-LOG.md, andSPEAKER-SCRIPT.md. - Check visible claims, notes, timing, and delivery wording for consistency with the approved brief, evidence ledger, story, and script.
- Reject stale, unsupported, or contradictory claims instead of polishing around them.
- Strict 1:1 Parity: Confirm slide count equals note count, including backup pages (
Slide Count === Speaker Note Count === PDF Page Count === PPTX Slide Count). - Language Purity: For target-language presentations (e.g. 100% English summit), verify zero stray secondary-language characters across all slides and notes.
- Check factual consistency across slides, notes, references, and exports.
- Run
node .agents/skills/make-presentation/scripts/unslop-check.mjs <slide-folder-or-notes> --strict. Fix every finding or record an exception with its reason inQA-REPORT.md. See../make-presentation/references/unslop-copy.md. - Confirm the main-talk range, backup range, total timing, and per-slide timing.
- Confirm one necessary job and one dominant message per slide.
- In research-enhanced mode, require a per-slide fact check plus a reference and Q&A backup plan before export approval.
Verify the preview & visual integrity
- Run the relevant repo checks and target build.
- Review the complete deck in the engine's live preview surface.
- Inspect full-page renders or a contact sheet, then inspect changed, dense, and image-heavy pages at full size.
- Reject verbose paragraphs and nested text tiers. Split the slide rather than shrink text or hide overflow.
- Aesthetic & Rendering Contract Verification:
- Verify compliance with the declared
Visual Direction & Rendering DNAinPRESENTATION-BRIEF.md. - Verify typography hierarchy (Hero titles reach 120px+, section headers 72px+, prominent display scale).
- If Sticker Pop / Sketch archetype was declared, verify all cards carry 3px ink borders and hard offset shadows (
8px 8px 0px), not generic diffuse soft shadows or 1px faint borders. - Verify visual diagram craft (SVGs match the aesthetic DNA, no raw generic boxes).
- Verify compliance with the declared
- Treat clipping, unreadable type, generic AI slop styling, inconsistent page grammar, or notes drift as failed QA.
Export and inspect
- After deck or exporter changes, produce a fresh export in each chosen delivery format; old downloads are not repaired.
- Unified Export: Run
node .agents/skills/make-presentation/scripts/export-deck.mjs <deck-id> --format=pdf,pptx(ornpx open-slide export <deck-id> --format=all) to automatically detect the engine and headlessly export fresh deliverables toexports/. - Automated QA Audit Pipeline: Run
node .agents/skills/make-presentation/scripts/qa-deck.mjs <deck-id> --export(ornpx open-slide qa <deck-id> --export) to execute an automated audit verifying 1:1 strict parity (Slide Count === Note Count === PDF Page Count === PPTX Slide Count), copy slop, text density, and PPTX OOXML structure. Pass--recordto automatically updateSTATUS.mdwith the verified deliverables upon passing. - Follow
adapters/<engine>/qa.mdfor the engine's export steps, archive integrity, geometry, and any native-application inspection. - Visual-Faithful Verification: Verify that the exported PPTX preserves visual layout without text box re-wrapping or bounding-box drift when opened in Microsoft PowerPoint.
- Speaker Notes Verification: Confirm speaker notes are properly embedded in the exported PPTX notes pane for every slide.
- If the preview and any export disagree, the export is not complete.
Record and hand off
- Sort remaining findings into Act on, Consider, Noted, or Dismissed using
../make-presentation/references/review-buckets.md. Any Act on finding blocks the gate. - Complete
templates/QA-REPORT.mdwith evidence for every section and any remaining caveats. - In pipeline mode, update the
production-qagate inSTATUS.mdthrough.agents/skills/make-presentation/scripts/status.mjs. - Provide direct links to every exported file, page/note counts, timing, inspected pages, and explicit export verification evidence.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

