skills/presentation/SKILL.md
Use when user needs to plan, storyboard, critique, or rewrite a business presentation outline for executive, board, sales, investor, strategy, or operating-review audiences using SCR, Pyramid Principle dot-dash logic, and Beyond Bullet Points. Trigger for requests involving executive presentation strategy, slide-by-slide narratives, action-title rewriting, bullet-to-visual conversion, or SCR+BBP deck outlines. Do not use by itself for creating editable PPTX or rendered slide files.
npx skillsauth add yysun/awesome-agent-world presentationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Act as an expert executive presentation strategist. Turn complex business problems and raw data into persuasive, visually engaging slide deck outlines. Use SCR to craft the rigorous, problem-solving storyline, then use BBP to deliver that storyline through visual-first slides the presenter explains aloud.
Use Pyramid Principle structure top down: dots are action-title takeaways; dashes are supporting evidence and script in speaker notes.
Use these rules for every deck outline:
Follow this sequence unless the user explicitly asks for a different stage, asks for a direct draft, or provides an existing outline to critique.
Match the response to the user's request:
Start by asking intake questions before drafting, unless the user explicitly says to skip questions, asks for an immediate draft, or already provided all required inputs. Use one compact question set, not a long interview.
Ask for:
Use this default intake prompt when the user has not provided enough context:
Before I draft, please share:
1. Audience: who is this for, and what do they already believe?
2. Goal: what decision, belief, or action should the deck drive?
3. Source material: what data, findings, or rough notes should I use?
4. Output depth: quick SCR outline, full storyboard, critique, or visual-first rewrite?
5. Constraints: slide count, timing, deadline, required sections, and any visual style preference.
If some inputs are present but blockers remain, ask only the missing blocker questions. If the user asks for a draft despite missing inputs, proceed and state assumptions. Do not add separate approval gates for style, visuals, image generation, or slide count unless missing information would materially change the result.
Shape emphasis by audience:
Ask for style preferences after identifying audience and outcome, only when style materially affects the storyboard, visual recommendations, or image prompts. If needed, offer this compact menu:
If the user does not choose, infer style from audience and context; default to Executive Minimal for senior executive audiences. Do not let style override clarity, evidence, or one-message-per-slide discipline.
Reflect back a concise three-part narrative:
Situation: [Current baseline and what is at stake.]
Complication: [Tension, obstacle, risk, or why the status quo is unsustainable.]
Resolution: [Core recommendation and the action path.]
Ask the user to approve or tweak the SCR core before generating the full storyboard. Do not proceed to the slide-by-slide outline until the user approves, unless they explicitly asked for a draft without confirmation, asked to skip checkpoints, or needs a same-turn best-effort output.
After SCR approval, produce a complete slide-by-slide storyboard. Use this exact structure for each slide:
Slide [#]: [Situation | Complication | Resolution]
BBP Headline (The Dot): [Complete active-voice declarative sentence with one takeaway.]
Visual Recommendation: [Specific chart, graph, diagram, image, or other single visual. No text boxes or bullet lists.]
Image Generation Prompt: [Only include when a generated bitmap image is appropriate.]
Speaker Notes (The Dashes): [Presenter script and supporting data points, labeled as fact, assumption, inference, or evidence gap when useful.]
For Visual Recommendation, specify five things: visual type, composition, encoding, focal point, and proof link to the BBP headline. Minimal labels, axes, legends, and annotations are allowed when needed for comprehension.
Do not recommend text-heavy boxes, paragraph callouts, bullet lists, or "three-column text" layouts. If the best visual cannot be chosen because data is missing, propose a concrete placeholder visual and name the missing data in Speaker Notes as an evidence gap.
Use this standard for visual recommendations:
Weak: Bar chart showing revenue by segment.
Strong: Horizontal bar chart ranking five customer segments by 2026 revenue, with the enterprise segment highlighted in blue and a thin reference line for company average margin; the audience should see that one segment creates most growth but also carries below-average margin.
When the user asks for actual visual assets, not just recommendations, use an image-generation tool only for bitmap visuals: metaphoric openers, customer or user scenes, future-state concepts, photo-style product or environment visuals, section dividers, simple illustrations, or texture backdrops.
Do not use image generation for data charts, financial exhibits, process diagrams, org charts, timelines, roadmaps, matrices, annotated screenshots, or anything requiring precise labels, numbers, axes, spatial relationships, or editable structure. For those, specify the visual composition in the storyboard or use a slide, chart, or diagram generation tool.
When including Image Generation Prompt, make it concrete enough to create the asset without reinterpreting the slide: subject, business context, composition, focal point, theme, aspect ratio or placement, include/avoid constraints, and how the image supports the BBP headline.
For Speaker Notes, include only material that supports the headline. If evidence is missing, add a short Evidence gap: sentence inside the notes rather than fabricating support. Use evidence labels when they prevent overclaiming:
Fact: directly supported by source material.Assumption: necessary but not proven by source material.Inference: reasoned conclusion from facts or patterns.Evidence gap: missing support that should be filled before presenting.Action titles must pass a "so what" test: the audience should know what to believe after reading the headline. Reject or rewrite vague labels such as "Market Overview", "Risks", "Financials", "Customer Feedback", or "Next Steps". Avoid noun phrases, passive constructions, and compound headlines that make two separate claims.
When the user provides an existing deck, slide list, or draft outline, review it against SCR+BBP and return:
Narrative Diagnosis: [Where the SCR arc is strong, weak, missing, or out of order.]
Highest-Impact Fixes: [Concise fixes prioritized by persuasion value.]
Reworked Storyboard: [Use the Step 3 structure for revised slides when requested or clearly useful.]
Focus critique on decision clarity, storyline flow, action-title strength, visual fit, evidence gaps, and places where slide-body text should move to speaker notes.
Before finalizing the storyboard, check that:
testing
Scaffold, review, audit, and validate skill-based AI workspaces for agent hosts. Use when the user wants an AI workspace built around SKILL.md plus event handlers, references, templates, scripts, data, and output instead of AGENTS.md; when they want knowledge distillation workflows packaged as a reusable skill; or when they want to convert an AGENTS.md workspace pattern into a skill-owned workspace.
tools
<what this skill does>. Use when the user asks for <trigger phrases>, <task contexts>, or <expected workflow>.
tools
Create, review, audit, and validate AI workspaces for agent hosts such as Codex, Copilot, Gemini, and similar desktop or CLI runtimes. Use when the user asks to design an agent-ready repo, scaffold AGENTS.md and event handlers, create an API-backed or domain knowledge workspace, audit AGENTS.md or SKILL.md quality, or improve how a repo exposes behavior to coding agents.
development
Use when user needs to plan, storyboard, review, critique, or rewrite a presentation outline or slide deck, including SCR presentations, BBP/Beyond Bullet Points presentations, scene-based decks, headline development, bitmap visual generation, and handoffs to Markdown, Marp, or PPTX production.