القائمة
Adds themed GIFs to selected slides in an existing deck. Use when a deck draft exists and the user wants to inject humor or energy with GIFs — picks a deck-wide theme (e.g. Matrix, Pixar, Office), lets the user choose which slides get a GIF, searches Giphy, and offers 3 options per slide.
Converts a brief, notes, transcript, document, or mixed source material into a presentation plan and saves it to the project's `docs/specs/` folder. Use when the input is messy or incomplete and you need to extract audience, goal, theme, narrative arc, section flow, and slide intent before building a deck.
Reviews a presentation deck for story consistency, pacing, structure, and audience fit, then proposes or applies concrete improvements. Use when a deck draft exists and you need to identify what is weak, confusing, redundant, or missing and update it accordingly.
Guided discovery for new presentations when there is no brief, notes, or source material yet. Asks structured questions one at a time to establish audience, format, tone, takeaway, and narrative direction, then produces a brief that feeds into brief-to-presentation-plan.
Converts an approved presentation plan into a concrete presentation deck. Use when you already know the audience, through-line, and slide flow and now need to produce slide structure, layout decisions, reveal order, animation, and implementation-ready deck content.
Turns numeric results, improvements, and comparisons into bold visual treatments instead of inline prose. Use on any slide that contains a number representing a result, change, gain, loss, target, or benchmark — bars, gauges, hero numbers, before/after panels, delta callouts, with a reason label explaining why the number moved.
| name | slide-gif-picker |
| description | Adds themed GIFs to selected slides in an existing deck. Use when a deck draft exists and the user wants to inject humor or energy with GIFs — picks a deck-wide theme (e.g. Matrix, Pixar, Office), lets the user choose which slides get a GIF, searches Giphy, and offers 3 options per slide. |
Use this skill after a deck draft exists and the user wants to sprinkle in GIFs — not everywhere, only where they add energy or humor. The job here is to run a short targeted flow: which slides → which theme → which GIF, then embed the chosen GIFs into the deck.
Skip when: there is no deck draft yet (go through brief-to-presentation-plan → presentation-plan-to-deck first), or the audience/tone is wrong for GIFs (board meeting, compliance review, etc.).
Momentum rule: GIFs are continuous loop motion. Loop motion competes with the deck's reveal-driven forward motion (see ../_shared/slide-philosophy.md, pillar 4). A GIF works only on slides whose forward motion is not already carried by step reveals — title slides, outros, transition beats, deadpan punchlines. Do not park a looping GIF on a slide that has its own reveal sequence carrying the audience forward; the loop will pull attention sideways instead of ahead.
GIPHY_API_KEY is set in the environment. Free keys: https://developers.giphy.com/. If missing, ask the user to export it before proceeding — do not hardcode keys, do not commit them.Read the deck file(s). Build a short list of slides that are plausible GIF candidates. Good candidates:
Bad candidates (skip by default):
Present the candidate list to the user and let them add/remove slides. One list, one confirmation — do not ask per-slide at this stage.
Ask for a single theme that will flavor every GIF search. Offer examples but accept freeform:
| Option | Description |
|---|---|
| A | Matrix |
| B | Pixar cartoons |
| C | The Office |
| D | 90s movies |
| E | Custom (user-provided) |
One theme per deck keeps the visual language coherent. If the user wants multiple themes, push back once — then comply if they insist.
For each slide in the confirmed list:
Derive a short search keyword from the slide's title or core idea (2–4 words, concrete nouns/verbs — e.g. "celebration", "confused", "mic drop", "lightbulb moment").
Combine with the theme: <theme> <keyword> (e.g. matrix confused, pixar celebration).
Call Giphy search, limit 3, rating pg-13 by default:
curl -sG "https://api.giphy.com/v1/gifs/search" \
--data-urlencode "api_key=$GIPHY_API_KEY" \
--data-urlencode "q=<theme> <keyword>" \
--data-urlencode "limit=3" \
--data-urlencode "rating=pg-13"
Present the 3 options to the user in a compact list:
Slide 4 — "We thought this would be easy"
Search: pixar confused
1. "Confused Dory" — https://media.giphy.com/.../giphy.gif
2. "Woody thinking" — https://media.giphy.com/.../giphy.gif
3. "Boo puzzled" — https://media.giphy.com/.../giphy.gif
S. Skip this slide
R. Retry with different keyword
Use the images.downsized.url (or images.original.url) field from the Giphy response. Include the GIF title for quick scanning.
Wait for the user's pick before moving to the next slide. Accept 1 / 2 / 3 / S / R or a freeform response.
Once all selections are made, embed each GIF into its slide. Match the deck's framework:
<img src="<gif-url>" alt="<title>" class="slide-gif"> — place it where the slide has breathing room (often after the headline, before the detail text). inside the slide's markdown block.Prefer the hosted Giphy URL over downloading — it keeps the deck lightweight and always-fresh.
Do not let the GIF become a second main thought. If adding it makes the slide text-heavy, crowded, or less clear, replace supporting prose with the GIF or skip the slide.
Summarize: slides updated, GIFs embedded, plus any slides where the user chose Skip or Retry was exhausted. Offer to run deck-review-update to re-check pacing now that visuals have changed.
Two things:
Updated deck file(s) with GIF embeds in place.
A change summary like:
## GIFs added
| Slide | Search | Chosen GIF |
|-------|--------|------------|
| 1 — Title | matrix welcome | "Neo waking up" |
| 4 — We thought this would be easy | pixar confused | "Confused Dory" |
| 12 — Mic drop | office drop | "Michael Scott mic drop" |
Skipped: slide 7 (user skipped), slide 9 (no good match after retry).
../_shared/slide-philosophy.md).GIPHY_API_KEY ends up in the deck file, scrub it.pg-13. Only relax with explicit user request.When done, suggest running deck-review-update — GIFs change pacing and visual weight, so a second pass catches slides that now feel busy or off-balance.