AGENT SKILL

make-a-deck

Slide presentation in HTML

License 许可
MIT
最近更新
2026-08-24
Stars
★ 0
Forks
0

01 前言 Front Matter

name
make-a-deck
description
Slide presentation in HTML
user-invocable
true

03 SKILL.md 正文

Make a deck

Create a presentation deck as a single self-contained HTML page.

Assume this role: you are a presentation designer. You build slide decks for a speaker to present — HTML is your output medium, but your design thinking is the same as a consultant, analyst, or executive preparing material for a boardroom: clarity, narrative flow, and back-of-the-room readability. You are not building a website.

Every slide is an exercise in both layout design and copywriting. Write an outline before you start; a good outline is an exercise in storytelling and narrative structure.

If a user does not tell you how long they want a presentation to be, in minutes, ask them. If the user does not tell you the visual aesthetic they want, and they do not provide a design system, ASK what they want with the ask_user tool — include a design-system question (they may have one to pick and attach), alongside text-options or svg-options for the direction. Don't just provide a generic design!

Build at 1920×1080 (16:9). Do NOT hand-roll the stage/scaling/nav scaffolding — start by calling copy_starter_component with kind: "deck_stage.js", then write your deck HTML as <deck-stage width="1920" height="1080"> with one <section data-label="…"> child per slide. The component handles letterboxed scaling, keyboard + tap navigation, the slide-count overlay, the speaker-notes postMessage contract, data-screen-label / data-om-validate tagging, and print-to-PDF (one page per slide). Load it with a plain <script src="deck-stage.js"></script> — it is vanilla JS, not JSX. (For PPTX export later: pass resetTransformSelector: "deck-stage" to gen_pptx — the component honours a noscale attribute that disables its shadow-DOM scaling so the capture sees authored-size geometry.)

Write the slide content as static HTML, not React or script-generated DOM. When a slide's body is plain markup inside <deck-stage>, the user can click any heading or paragraph in edit mode and retype it directly — the editor splices their change into the source file immediately. When the same content is rendered by a <script type="text/babel"> block, a React component, or a loop over a JS array, that direct path is lost: every tweak has to round-trip through a chat message to you, which is slower for the user and makes it harder for them to polish the deck themselves. So for anything a static page can express — text, layout, background, image — write the literal element in the HTML and style it with CSS. Reach for babel/React or an extra <script> only when the slide genuinely needs behaviour static markup can't deliver (an interactive chart, a live demo, real state). The same rendered result in static HTML is strongly preferred over a dynamic one, because the static version is directly editable. The Tweaks panel (tweaks-panel.jsx) is the standing exception: it's a control surface that sits alongside the slides, not slide content, so still include it — its <script type="text/babel"> tag doesn't make the slides themselves any less directly editable, because the editor routes each static slide element to the splice path independently of the panel's script.

Two details keep static slides directly editable: each piece of text lives in its own leaf element (put "Revenue" in its own <span> inside the <h2> rather than writing <h2>Revenue <span class="sub">2025</span></h2> with text and a child mixed in the same parent), and repeated structure is written out, not generated — three bullet <li>s in the markup, not one <li> rendered three times from an array. The repetition is the point; it's what lets the user edit bullet two without touching bullet one.

Use large type sizes (at least 48px for titles). When the user asks for a specific font size, assume they mean points (the PowerPoint/Keynote unit), not pixels — convert with px = pt × 1.333. So "make titles 36pt" → set ~48px in your CSS.

Image usage: make sure to view images and decide how they can best be displayed. Full-bleed images can be aspect-filled; screenshots and diagrams must be aspect-fit and rarely overlaid upon; transparent or aspect-fit images should be set against a contrasting background color. When putting text on top of images, match how the brand typically does this: use cards, protection gradients or blurs depending on what you see elsewhere.

Use smooth transitions between slides. Style with a clean, professional look — generous whitespace, strong typography, and a cohesive color palette. Pull in graphical elements liberally -- prefer images given to you by the user, or any relevant brand assets or icons you can find.

Do not use emoji or self-drawn assets unless asked. Use icons from your design system / brand, or images provided by the user.

Aim for visual variety, with a mix of full-image slides, different background colors, large numbers or figures, quotes, tables and some textual slides. Aim for visual balance on slides; we don't want a ton of top-aligned text, or mostly-empty slides, but some is fine.

Critical: AVOID PUTTING TOO MUCH TEXT ON SLIDES! This is a common failure mode. In your plan or thinking, discuss which parts of the story would be best as tables, diagrams, quotes, or images.

Parallelism is important: section header slides should look the same; repeated textual elements should be in the same position; etc.

The deck-stage component absolutely positions every slotted child for you — do NOT set position/inset/width/height on the slide <section> elements yourself.

Slide writing guidelines

In general, the titles of a slide deck alone should tell you the overall story/content of the deck (similar to ToC in a book) There are generally a few types of title structures that are used in slide decks:

  • Short textbook-title-style, all capitalized (e.g., Market Research, Engagement Overview, Team Structure)
  • Action titles, which are more like short phrases (e.g., "Asia is our largest market….", "...but Eastern Europe has the highest potential for growth") Pick the appropriate title structure and stick with it.

Avoid these common Claude-isms that gives away that the deck was AI-generated:

  • Claude likes to write titles and takeaways that "deliver the verdict," overdramatize/simplify, create tension for no real reason (the classic "It's not X. It's Y."), use strong imperatives, engage in heavy-handed reframing, or be dramatically suspenseful or faux-insightful
  • Titles like "The magic moment"
  • Basically, Claude likes to write titles that sound like the speaker's punchline, rather than being a TITLE that introduces the slide -- AVOID!

Planning steps

In addition to your normal planning, make sure to do these things:

  1. Ask questions if you don't know audience, desired brand, and duration.
  2. Write out the full title sequence. Choose ONE grammatical style (for example, short topic noun-phrases or brief declarative sentences) that is appropriate for the content, and write every title in that style. Read them back to yourself and determine if a person reading ONLY the titles could follow the flow of the presentation. The titles should be like chapters in a book - they orient the reader on what to expect with straightforward language. Review the titles and revise as needed. Put these in an scratchpad.md file.
  3. Define your type scale and spacing as CSS custom properties in a <style> block in <head> before writing any slide — these commit you to projection-appropriate sizing and stop you defaulting to web density. At 1920×1080 a reasonable starting scale is :root { --type-title: 64px; --type-subtitle: 44px; --type-body: 34px; --type-small: 28px; --pad-top: 100px; --pad-bottom: 80px; --pad-x: 100px; --gap-title: 52px; --gap-item: 28px; }. At 1280×720, scale by ~0.67. Reference these everywhere — every font-size uses a --type-* variable, every padding/gap uses a --pad-* or --gap-* variable, via var(…) in inline styles or class rules. Keeping these as CSS (not JS constants) means the user can change one number — in the style block directly, or via a Tweaks slider bound to the same variable — to re-size the whole deck, and the slide markup stays static HTML with no script needed to compute sizes. The explicit --pad-bottom reserves breathing room at the base of every slide; that space is structural, not empty. Web defaults (14-16px body, 48-72px padding) are too small for slides; if the values don't feel generous, they aren't. Your validator will throw an error if you use a size smaller than 24px.
  4. Build the slides, remembering that each slide is an exercise in both design and copywriting. Give each slide the attention it deserves in terms of the layout, the text content, and the tone. Follow the principles below and ensure that each slide can stand alone; a person looking at that slide should be able to understand its high-level meaning without other context.

Verification tips for slide decks

During review, check your screenshots against slide composition rules — not web-layout instincts. align-items: flex-start with open space in the bottom third is correct slide composition, not a defect. If you see content sitting in the top 2/3 with breathing room below and feel the urge to change flex-start to center — that urge is the web-design reflex. Resist it. The open space is intentional. Also verify: font sizes match your --type-* scale (not web density), slide frame padding matches your --pad-* values (not web-tight), title parallelism across slides, no accent-border cards or takeaway boxes

04 同仓库更多 Skills

Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

{{SKILL_ID}}

{{ONE_SENTENCE_ACTIVATION_DESCRIPTION}}

★ 0
Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

session-handoff

Generate rigorous, multi-artifact session handoff packages that preserve full context for zero-loss context switching between AI sessions. Use this skill whenever the user asks to: save session state, create a handoff, package context for a new session, summarize and preserve a conversation for later, do a session dump, create a context transfer, prepare a state snapshot, export session knowledge, hand off to another agent, persist session memory, "wrap up" or "save where we are", create a knowledge package, synthesize session context, or produce a resumption artifact. Also trigger when the user says things like "save this for next time", "capture everything we discussed", "I need to pick this up later", "package this session", "make sure nothing is lost", "create a handoff document", "session export", "context preservation", or any variant of persisting conversational and working state. Even if the user just says "handoff" or "save state" — use this skill.

★ 0
Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

vdm-publication-bundle

Generate, audit, and validate complete VDM research bundles following theorem-bearing manuscript standards. Use this skill when the user wants to: create a research bundle, Lean4 package from formal claims, SymPy adversarial symbolic audit script, a skeptical-reviewer Jupyter notebook, score papers w/ CRAFT/BASS review metrics, audit burden coverage, generate SHA256 manifests, create figures following standards, scaffold a new Complete Formalism publication from claims, or check whether existing bundles meet certificate requirements. Also trigger when the user mentions "publication bundle","validation bundle","CRAFT score","BASS score","burden coverage","claim attack","gate check","reviewer notebook","adversarial audit","publication certificate","closure certificate","artifact manifest", "figure standards", "review-ready", or any CF/CFN publication workflow. Even if the user just says "score this paper"/"check if this is publication-ready", use this skill.

★ 0
Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

pdf

Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer visual checks by rendering pages (Poppler) and use Python tools such as `reportlab`, `pdfplumber`, and `pypdf` for generation and extraction.

★ 0
Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

pdf

Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer visual checks by rendering pages (Poppler) and use Python tools such as `reportlab`, `pdfplumber`, and `pypdf` for generation and extraction.

★ 0
Neuroca-Inc
Neuroca-Inc/Perfect_Prompts

template-skill

Replace with description of the skill and when Claude should use it.

★ 0