Initial commit: Hermes Agent Skills collection

2026-07-12 19:02:59 +00:00
commit e9cc106625
789 changed files with 233126 additions and 0 deletions
@@ -0,0 +1,58 @@
+# Iterative Fix-Verify Loop for Presentation QA
+
+Pattern for achieving zero-defect presentations through repeated visual QA cycles.
+Derived from a 17-slide deck QA session (5 cycles, 6 issues → 0 issues).
+
+## The Loop
+
+```
+┌─────────────────────────────────────────┐
+│  1. GENERATE  →  node main.js           │
+│  2. RENDER    →  soffice → pdftoppm     │
+│  3. BATCH QA  →  batch_vision_qa.py     │
+│  4. TARGETED  →  vision_analyze (deep)   │
+│  5. FIX       →  patch source files      │
+│  6. REPEAT 2-5 until ALL CLEAN          │
+└─────────────────────────────────────────┘
+```
+
+## Cycle Progression (Real Example)
+
+| Cycle | Issues Found | Action | Remaining |
+|-------|-------------|--------|-----------|
+| 1 | 1 (batch) + 6 (targeted) | Fixed all 6 | 3 remaining |
+| 2 | 3 (targeted) | Fixed all 3 | 1 remaining |
+| 3 | 1 (targeted) | Fixed | 1 remaining |
+| 4 | 1 (targeted) | Fixed | 0 |
+| 5 | 0 (full batch) | Done | 0 ✅ |
+
+## Why Multiple Cycles Are Needed
+
+Fixes introduce new problems:
+- Moving a subtitle down to fix overlap may push it into content below
+- Enlarging a badge circle may overlap neighboring elements
+- Changing line color for visibility may reduce contrast with another element
+- Shortening a label to prevent wrapping may lose meaning
+
+**Never declare success after the first fix-and-verify.** Always re-render and re-QA.
+
+## Batch + Targeted Prompt Division
+
+### Batch Prompt (Tier 1 — Breadth)
+Generic, checks all slides quickly (~25s for 17 slides). Uses expanded 6-category prompt:
+overlap, overflow, contrast, layout, content, symbols.
+
+### Targeted Prompts (Tier 2 — Depth)
+Element-specific questions for slides with:
+- **Diagrams**: "Are the connecting lines visible? What color?"
+- **Badges/icons**: "Do the letters inside circles render correctly?"
+- **Tables**: "Are all cells populated? Any placeholder text?"
+- **Examples**: "Does the example value match the description?"
+- **Arrows/connectors**: "Do arrows render properly between elements?"
+
+## Efficiency Tips
+
+- Only re-render and re-QA slides that were changed (not the entire deck)
+- But ALWAYS do a full batch scan at the end to confirm no regressions
+- Batch QA via direct API calls is 10-20x faster than sequential vision_analyze calls
+- Save QA results to JSON for comparison between cycles