Ghid operator pentru skill-ul PPTX

Ce face

Skill-ul pptx se folosește ori de câte ori un fișier PowerPoint este implicat ca input, output sau ambele. Acoperă citirea, extragerea textului, analiza vizuală, crearea, editarea, actualizarea, combinarea, împărțirea și verificarea prezentărilor .pptx.

Intră aici prezentări, pitch decks, slide decks, template-uri, layout-uri, speaker notes și comments. Dacă sursa este un .pptx, skill-ul rămâne relevant chiar dacă rezultatul final este un rezumat, un email, o notă sau alt document.

Pe scurt: un .pptx nu este tratat ca text generic. Este un obiect vizual cu structură, layout, ordine de citire, spațiere, contrast și risc de randare greșită.

Vezi și All guides pentru restul capabilităților.

Când îmi folosește

Îți folosește când ai de lucrat cu o prezentare PowerPoint și vrei:

• să creezi un deck nou;
• să editezi sau să actualizezi o prezentare existentă;
• să extragi text dintr-un .pptx;
• să analizezi vizual slide-urile;
• să lucrezi cu un template sau o prezentare de referință;
• să combini sau să separi slide-uri;
• să verifici un deck înainte de livrare.

Skill-ul pune accent pe design, nu doar pe conținut. Un deck bun nu este o listă de bullets pe fundal alb. Fiecare slide ar trebui să aibă un element vizual: imagine, chart, icon, shape, callout sau structură vizuală clară.

Cum îl invoc / declanșez

Se declanșează la orice mențiune de deck, slides, presentation sau la orice filename .pptx.

Exemple:

• „Creează o prezentare despre X”
• „Extrage textul din presentation.pptx”
• „Editează deck-ul acesta”
• „Fă un pitch deck”
• „Combină slide-urile”
• „Verifică dacă prezentarea are probleme”

Comenzile canonice sunt:

python -m markitdown presentation.pptx

pentru extragere text,

python scripts/thumbnail.py presentation.pptx

pentru overview vizual,

și

python scripts/office/unpack.py presentation.pptx unpacked/

pentru XML brut.

Pentru editare sau creare din template se folosește ghidul intern de editare. Pentru creare de la zero se folosește fluxul bazat pe pptxgenjs. Disponibilitatea depinde de runtime: pot fi necesare markitdown[pptx], Pillow, pptxgenjs, LibreOffice și Poppler. Dacă lipsesc, nu se inventează output; se raportează blocajul.

Exemplu practic

Ai presentation.pptx și vrei un rezumat. Cererea este: „Extrage conținutul din presentation.pptx și spune-mi ce e în el.”

Fluxul corect începe cu:

python -m markitdown presentation.pptx

Apoi se verifică ordinea logică, conținutul lipsă, typo-urile și textul placeholder. Pentru prezentări generate sau bazate pe template, verificarea minimă este:

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

Dacă apar rezultate, prezentarea nu este gata.

Pentru QA vizual, deck-ul se convertește în imagini:

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

Apoi slide-urile se inspectează critic: suprapuneri, text tăiat, contrast, margini, aliniere, spacing și placeholder-uri.

Output / unde aterizează

Output-ul poate fi:

• text extras dintr-un .pptx;
• o prezentare .pptx nouă;
• o prezentare modificată;
• imagini ale slide-urilor pentru QA vizual;
• listă de probleme găsite într-un deck;
• structură reutilizabilă pentru alt artefact.

Locul exact al fișierului nu este definit de skill. Depinde de cerere, runtime și configurația mediului. Nu se presupune un folder fix. Nu se suprascriu fișiere importante fără instrucțiune clară sau backup. Nu se trimite prezentarea extern fără cerere explicită.

Limite / gotchas

Primul render este suspect. QA-ul este obligatoriu, nu decorativ. Dacă nu s-a găsit nicio problemă la prima inspecție, probabil inspecția a fost prea blândă.

Problemele tipice: elemente suprapuse, text tăiat, titluri rupte peste decor, citări sau footere care intră în conținut, margini sub 0.5”, coloane nealiniate, spații inconsistente, contrast slab, icon-uri invizibile și placeholder text rămas.

Reguli de design: nu folosi albastru generic fără motiv, nu repeta același layout peste tot, nu centra body text, nu crea slide-uri doar cu text, nu folosi fonturi default din lene și nu pune accent lines sub titluri. Titlurile ar trebui să fie 36–44pt bold, body text 14–16pt, iar spațiile dintre blocuri 0.3–0.5”.

Succesul se declară doar după verificare reală: generezi, convertești, inspectezi, repari și reverifici slide-urile afectate. Altfel ai doar un fișier. Posibil frumos. Posibil mort în colțuri.