菜单
Author markdown files optimized for Gamma import — card structure, layout hints, image directives, speaker notes, and chat-agent refinement workflow
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/aibot88/sec_skill_store --skill gamma-presentation命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| type | skill |
| lifecycle | stable |
| inheritance | inheritable |
| name | gamma-presentation |
| description | Author markdown files optimized for Gamma import — card structure, layout hints, image directives, speaker notes, and chat-agent refinement workflow |
| tier | extended |
| applyTo | **/*gamma*,**/*presentation* |
| currency | 2026-04-23T00:00:00.000Z |
| lastReviewed | 2026-04-30T00:00:00.000Z |
Staleness Watch: See EXTERNAL-API-REGISTRY.md for source URLs and recheck cadence
This skill teaches you to write markdown that imports cleanly into Gamma, then refine the result using Gamma's in-app AI chat agent. Two workflows are supported:
.github/muscles/gamma-generator.cjs posts directly to the Gamma API (one-shot)Choose manual when the user wants creative control over layout, image style, and theme. Choose API when speed matters more than polish.
---Each --- (markdown horizontal rule on its own line, blank line above and below) becomes a new card. Cards are Gamma's slide unit. Without explicit ---, Gamma's importer auto-splits unpredictably.
# Quarterly Review
Opening card content.
---
## Revenue
Second card.
---
## Next Steps
Third card.
Rule of thumb: One core idea per card. If a card needs scrolling at 16:9, split it.
| Markdown | Gamma role |
|---|---|
# H1 | Title card — use exactly once at the top |
## H2 | New card title |
### H3 | Section header within a card |
#### H4 | Sub-section / column header |
Do not skip levels. # Title → ## Card → ### Section keeps the importer's outline correct.
| Card type | Body words | Bullet count |
|---|---|---|
| Title / section divider |
| 0–10 |
| 0 |
| Content card (16:9) | 40–80 | 3–5 |
| Detail / data card | 80–140 | 5–8 |
| Appendix card | up to 200 | 8–12 |
Long-form documents (mode document) tolerate more; presentations should breathe.
Gamma reads HTML comments as speaker notes:
## Pricing Strategy
We're moving to tiered pricing in Q3.
<!-- Speaker note: Emphasize the migration window. Reference the Q2 churn data
when asked. Do not commit to a launch date — legal review pending. -->
Notes are hidden in published view, exported in PPTX speaker-notes panel.
Three patterns, in order of fidelity:
| Pattern | When to use |
|---|---|
 | Exact image you control |
![A photorealistic close-up of a chess piece on a marble board, dramatic side lighting]() (empty src) | Let Gamma's AI generate from your alt text |
<!-- gamma-image: cinematic shot, low-angle, golden hour, no text --> (HTML comment marker) | Hint for the chat agent to swap later — placeholder card uses theme default |
Write alt-text prompts as if briefing a photographer: subject, framing, lighting, mood, what to exclude (no text, no people, no logos).
Standard pipe tables import as Gamma tables:
| Tier | Price | Seats |
|---|---|---|
| Starter | $29/mo | 5 |
| Pro | $99/mo | 25 |
| Enterprise | Custom | Unlimited |
Keep ≤ 5 columns, ≤ 8 rows per card. Wider tables → split or move to appendix.
Gamma renders simple data via its chart card. To hint the importer, use a fenced block labelled chart with TSV/CSV:
```chart
type: bar
title: Revenue by Quarter
Q1 120
Q2 145
Q3 180
Q4 210
```
For complex visualizations, generate the chart externally (data-visualization skill) and embed as an image.
Gamma's importer recognizes a 2- or 3-column layout from ### siblings within a card:
## Comparison
### Old Approach
- Manual ticketing
- Email follow-up
- 5-day SLA
### New Approach
- Auto-routed
- Slack threads
- 4-hour SLA
The card renders as side-by-side columns. Keep parallel structure (same bullet count).
Use blockquote with a leading emoji to trigger Gamma's callout card style:
> 💡 **Insight**: 73% of churned customers never opened the onboarding email.
> ⚠️ **Risk**: API rate limits cap us at 12K syncs/hour during the launch window.
For appendix detail that shouldn't crowd the main flow, use HTML <details>:
<details>
<summary>Methodology</summary>
We surveyed 1,240 users across 3 cohorts between Jan and Mar 2026...
</details>
Gamma renders these as expandable toggles.
Every well-formed Gamma source follows this shape:
# {Deck Title}
{One-sentence promise of what the audience will learn.}
<!-- Speaker note: Audience = {who}. Goal = {what they should do next}.
Tone = {confident / exploratory / instructive}. -->
---
## Agenda
1. The problem
2. What we did
3. What changed
4. What's next
---
## {Section 1 Title}
{Body — 40-80 words or 3-5 bullets.}
![Illustrative image alt text — describe scene, lighting, mood]()
---
{... more cards ...}
---
## Recommendation
> 💡 **Bottom line**: {one sentence}
---
## Appendix
<details>
<summary>Methodology</summary>
...
</details>
<details>
<summary>Data sources</summary>
...
</details>
Always end with an Appendix section using <details> toggles for backup data, methodology, glossary, and FAQs. The audience sees a clean main flow; the presenter has depth on demand.
Draft the markdown file using the skeleton above. Keep it under 75 cards (Gamma's import limit).
Pre-process with the preprocessor muscle to auto-insert card breaks, demote stray H1s, and flag dense cards / weak alt-text:
node .github/muscles/md-to-gamma.cjs ./deck.md
# writes ./deck-gamma.md with inline <!-- Gamma: ... --> recommendations
Or right-click any .md in VS Code Explorer → Convert Markdown → Gamma (preprocess).
Validate locally: render to HTML (md-to-html skill) or PPTX (md-to-word → PowerPoint) to sanity-check structure before paying for credits.
Import to Gamma:
<name>-gamma.mdRefine via chat agent (see next section)
Export as PPTX or PDF
This workflow gives the user control over theme, brand, and per-card image direction.
Use .github/muscles/gamma-generator.cjs when speed matters and the user is okay with the default theme:
node .github/muscles/gamma-generator.cjs --file ./deck.md --slides 12 --dimensions 16x9 --export pptx --open
Always pass --slides N and --dimensions 16x9 for presentations. Without them, Gamma auto-splits and may default to fluid layout.
For draft-then-edit workflow:
# 1. Generate draft markdown
node .github/muscles/gamma-generator.cjs --topic "Q2 review" --draft --draft-output ./q2.md
# 2. User edits q2.md in VS Code
# 3. Generate final
node .github/muscles/gamma-generator.cjs --file ./q2.md --slides 14 --dimensions 16x9 --export pptx --open
Full parameter reference: see instructions/gamma-presentation.instructions.md.
Once the deck is open in Gamma's editor, the sparkle icon ✨ opens the AI chat agent. It can edit any card, regenerate images, restyle the whole deck, translate, and add new cards.
| Goal | Prompt template |
|---|---|
| Tighten a wordy card | "Condense this card to 3 bullets, keep the data point" |
| Regenerate one image | "Replace this image with a wide cinematic shot, low-angle, no people" |
| Restyle whole deck | "Apply a more conservative tone — dark navy theme, serif headings, minimal images" |
| Add a missing card | "Insert a 'Next Steps' card after Pricing with 4 owner/date bullets" |
| Fix imbalance | "Card 6 is much denser than the others — split it into two" |
| Translate | "Translate the deck to Brazilian Portuguese, keep the data labels in English" |
| Generate speaker notes | "Add 2-sentence speaker notes to every card that has data" |
| Add data viz | "Convert this table into a horizontal bar chart, sorted descending" |
Agent does well:
Agent struggles with:
Rule: Use markdown for structure, agent for polish. If you find yourself re-prompting the agent 4+ times for the same card, the source markdown is wrong — fix it there and re-import.
When generating or reviewing a Gamma source file, proactively call out these issues:
| Issue detected | Recommendation to user |
|---|---|
| First card has more than a title | "Add a one-sentence promise under the H1 — Gamma's title card looks empty otherwise" |
| Any card body > 140 words | "Card N is too dense for a 16:9 slide — split or move detail to an appendix toggle" |
No ![]() image directives | "No image prompts found — Gamma will use stock images. Add 2-3 alt-text prompts for hero cards" |
| No speaker notes | "Add <!-- Speaker note: ... --> blocks for talking points — they export to PPTX" |
| No appendix | "Add ## Appendix with <details> toggles for methodology and data sources" |
| Heading levels skip (H1 → H3) | "Heading hierarchy skips a level — Gamma's outline will look broken" |
| Identical bullet counts across all cards | "Vary card density — uniform cards feel monotonous; mix bullets, tables, callouts, images" |
All-text deck with --image-model set | "No ![]() directives but image-model is set — generation will be expensive without alt-text guidance" |
Default 10-card deck with standard images: 80–150 credits (~$1.50–3 on Pro plans).
Tier the image model to deck importance:
flux-quick (2 credits)flux-pro (10 credits) — recommended defaultimagen4 or recraft (25 credits)flux-ultra or gpt-image-hd (75–125 credits)Full model table in instructions/gamma-presentation.instructions.md.
instructions/gamma-presentation.instructions.md — auto-loaded routing + muscle parametersprompts/gamma.prompt.md — /gamma command referencemuscles/md-to-gamma.cjs — markdown preprocessor (name.md → name-gamma.md); also surfaced as Convert Markdown → Gamma (preprocess) in the VS Code right-click menumuscles/gamma-generator.cjs — API runner (one-shot generation)skills/presentation-tool-selection — Marp vs Gamma vs manual decision matrixskills/data-visualization — produce chart images for embedskills/markdown-mermaid — diagrams that survive Gamma importskills/brand-asset-management — upload brand assets to Gamma workspace before generation