KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

presentation-skills

★ 164 Open GitHub ↗

面向 Codex CLI 的演示工作流 skills 集合，包括商业级可编辑 PPT 协作与网页 demo 配音视频合成等可复盘、可复用流程。A Codex CLI skill collection for reusable presentation workflows, covering editable PPT diagram collaboration and end-to-end web demo video synthesis.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <table>
    <tr>
      <td style="vertical-align: middle;">
        <img src="assets/presentation-skills-logo.svg" alt="presentation-skills logo" width="120" />
      </td>
      <td align="left" style="padding-left: 24px;">
        <h1 style="margin: 0 0 8px;">presentation-skills</h1>
        <p style="margin: 0 0 12px;">
          <strong>Agent presentation skills for real office delivery</strong><br/>
          Generate editable PowerPoint decks, formal Word documents, and publishable demo videos,<br/>
          while keeping page narrative, Chinese typography, native Office tables / charts, and QC in one workflow.
        </p>
        <p style="margin: 0 0 12px;">
          <a href="https://github.com/Sven-LI-sankyuu/presentation-skills/releases/latest">
            <img src="https://img.shields.io/badge/release-skill%20zips-2ea44f?style=flat-square" alt="skill zip releases" />
          </a>
          <img src="https://img.shields.io/badge/skills-4%20packaged-2b579a?style=flat-square" alt="4 packaged skills" />
          <img src="https://img.shields.io/badge/output-editable%20Office-d2492a?style=flat-square" alt="editable Office output" />
          <img src="https://img.shields.io/badge/QC-table%20%2B%20typography-6f42c1?style=flat-square" alt="table and typography QC" />
          <img src="https://img.shields.io/badge/review-render%20preview-brightgreen?style=flat-square" alt="render preview review" />
        </p>
        <p style="margin: 0;">
          <a href="README.zh.md">🇨🇳 中文 README</a>
        </p>
      </td>
    </tr>
  </table>
</div>

<table>
  <tr>
    <td width="25%">
      <strong>📋 Close to real office scenarios</strong><br/>
      Covers research reports, management briefings, technical proposals, defenses, product demos, keynote-style talks, and template-driven business materials, with separate handling for reading decks and speaking decks.
    </td>
    <td width="25%">
      <strong>✏️ Original Office editability</strong><br/>
      Prioritizes native PowerPoint / Word text, shapes, tables, charts, and necessary connectors, so teams can revise copy, numbers, and layouts after handoff.
    </td>
    <td width="25%">
      <strong>📄 Formal Chinese typography details</strong><br/>
      Supports Songti / Heiti, Times New Roman, 小四 body text, 1.5x line spacing, 0.5-line before / after paragraph spacing, 五号 table text, and right-aligned financial numbers.
    </td>
    <td width="25%">
      <strong>🔍 QC reduces rework</strong><br/>
      Checks text overflow, object overlap, font-size drift, vertical centering in tables, special table indentation, full-slide screenshot backgrounds, and preview boundary risks.
    </td>
  </tr>
</table>

<br/>

## Product Logic: Constrain Model Output with Real Office Experience

As model capability improves, models will become increasingly fluent at using code tools to operate carriers such as PPT and Word directly. But PPT, Word, and even web video recording are more of a product problem. Improvements in model reasoning and coding ability do not naturally make models understand human office needs for PPT, such as specific typography information like fonts and line spacing, and more detailed text-writing logic and standards. The main creator of this skill has work experience in institutions such as large securities firms and private investment funds, and has solidified these experiences and logic into specifications and quality checks, so as to constrain models to produce PPT, Word, and video deliverables that better match real work needs. This is the core value of this skill.

| Skill | Best For | Product / Technical Highlights |
| --- | --- | --- |
| `ppt-polished-deck-collab` | Editable research reports, executive decks, strategy narratives, technical explainers, keynote-style talks, template-driven business decks | Connects brief, page narrative, slide specs, native charts / tables, preview export, and three-layer QC into a full deck workflow, with emphasis on reducing font drift, text overflow, uncentered tables, and non-editable screenshots |
| `word-polished-doc-collab` | Formal reports, board attachments, research appendices, policy docs, consulting-style Word deliverables | Encodes typography, font size, line spacing, paragraph spacing, captions, table indentation, and vertical-centering rules for Chinese formal documents and English consulting reports, making DOCX output closer to review-ready office files |
| `web-demo-video-synthesis` | Product walkthroughs, narrated web demos, short-form explainers, publishable demo videos | Splits scripts, segmented voiceover, timeline, browser recording, subtitles, and ffmpeg composition into manageable assets, supporting partial reruns and audio-video sync checks |
| `xhs-markdown-card-collab` | Publishable Xiaohongshu image-card posts from Markdown, research/job posts, structured note-style social content | Uses YAML front matter, real browser layout, pagination QA, and theme constraints to control mobile readability and avoid turning long text into unreadable screenshots |

<br/>

## 30-Second Start

You can send the repository link directly to your agent and ask it to install the PPT skill:

```text
Please open https://github.com/Sven-LI-sankyuu/presentation-skills/ and install the ppt-polished-deck-collab skill from it.
```

Download the latest skill zip: [GitHub Releases](https://github.com/Sven-LI-sankyuu/presentation-skills/releases/latest)

If you download the all-skills package, unzip it into the Codex skills directory:

```bash
mkdir -p ~/.codex/skills
unzip presentation-skills-all-skills-*.zip -d ~/.codex/skills
```

After installation, tell your agent:

```text
Use ppt-polished-deck-collab to turn this material into a formal, editable PPT that exports previews and completes QC.
```

You can also replace `ppt-polished-deck-collab` with `word-polished-doc-collab`, `web-demo-video-synthesis`, or `xhs-markdown-card-collab`.

<br/>

## PowerPoint Decks

`ppt-polished-deck-collab` covers multiple deck types through one workflow:

| Scenario | What it can produce | Demo / Gallery / Evidence |
| --- | --- | --- |
| Formal financial report / research deck | Native Office charts, native tables, source notes, disclaimers, stable report layout | [Apple FY2025 financial report review](demos/apple-financial-report-review/README.md) |
| Editorial / keynote-style analysis | Large serif titles, visual rhythm, native shape charts, strong art direction without HTML screenshots | [Apple editorial ink native test](demos/apple-editorial-ink-native/README.md) |
| Strategy / executive deck | Management questions, comparison matrices, decision logic, diagrams, narrative pacing | [PPT skill page](docs/ppt-polished-deck-collab.md) |
| Technical explainer / architecture deck | Dataflow, system diagrams, connector-backed editable structures, validation reports | [PPT skill page](docs/ppt-polished-deck-collab.md) |
| Template-driven business deck | Template audit, master/layout evidence, branded rebuild when needed | [PPT skill page](docs/ppt-polished-deck-collab.md) |

Full PPT skill page: [docs/ppt-polished-deck-collab.md](docs/ppt-polished-deck-collab.md)

## PPT Gallery

| Same Apple topic, editorial presentation | Same Apple topic, formal research report |
| --- | --- |
| [![Apple editorial ink native test contact sheet](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/apple-editorial-ink-native_contact-sheet.png)](demos/apple-editorial-ink-native/README.md) | [![Apple FY2025 financial report review contact sheet](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/apple-financial-report-review_contact-sheet.png)](demos/apple-financial-report-review/README.md) |
| A native PPTX translation of guizang-style editorial ink: large type, dark/light rhythm, ghost numerals, shape charts, and no HTML screenshots. | A formal Chinese financial-report deck with native Office charts, native tables, stable report layout, source notes, and validation evidence. |

**Editorial page spotlight**

[![Apple editorial ink iPhone and Services page](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/demos/apple-editorial-ink-native/build/rendered/ppt_preview/slide_004.png)](demos/apple-editorial-ink-native/README.md)

A single native PPTX page showing the editorial treatment: iPhone as the revenue center, Services as the stable second curve, stacked composition, embedded trend evidence, and a dark magazine-style page rhythm.

| Reproducible data-pipeline page | Financial evidence page |
| --- | --- |
| [![Apple editorial ink data pipeline page](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/demos/apple-editorial-ink-native/build/rendered/ppt_preview/slide_008.png)](demos/apple-editorial-ink-native/README.md) | [![Apple FY2025 revenue and net-income page](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/apple-financial-report-review_revenue-page.png)](demos/apple-financial-report-review/README.md) |
| A reproducible data chain from SEC API and 10-K HTML to extraction scripts and native PPTX, showing how automated materials preserve the evidence path. | A single evidence page showing how financial data, chart title, unit, source note, and key message are assembled. |

## Other Artifact Demos

[![Word refined consulting-report demo spread](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/word-refined-industrial-service-transformation_spread.png)](demos/word-refined-industrial-service-transformation/README.md)

[![Web Demo Video Synthesis preview](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/demos/web-demo-video-synthesis-financial-agent/assets/preview_en.png)](demos/web-demo-video-synthesis-financial-agent/README.md)

## Prompt Example

![Prompt example for the Apple financial report review deck](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/ppt-prompt-example.jpg)

This prompt style is intentionally specific about workspace placement, source data, reference style, disclosure language, and the `ppt-polished-deck-collab` skill route. The Apple demo turns that kind of request into a reproducible research-report workspace with durable source context and review evidence.

## Recent Updates

- `2026-05-13` 🎨 Added the Apple editorial-ink native PPTX demo and the dedicated PPT skill showcase page.
- `2026-05-10` 📊 Made Apple FY2025 financial report review the flagship formal PPT demo.
- `2026-05-10` Added Chinese formal-report typography and financial-table defaults for PPT.
- `2026-05-05` Upgraded XHS fictional demos into rendered PNG bundles.
- `2026-05-04` Added `xhs-markdown-card-collab` for Markdown-to-image-card posts.
- `2026-04-30` Added two Word demo workspaces with preview and QA evidence.
- `2026-04-29` Added `word-polished-doc-collab` for formal DOCX workflows.
- `2026-04-22` 🛡️ Added PPT checks for file integrity, slide structure, and rendered previews.
- `2026-04-22` Tightened the PPT template route from template review to final delivery.

## What This Repo Provides

### `ppt-polished-deck-collab`

`ppt-polished-deck-collab` produces editable, high-quality, highly automated PowerPoint decks for both business and academic use. It can build a new deck from scratch, work from a user-provided template, inherit a user’s existing slide master and layouts, and modify an existing `pptx` while preserving editability.

It is designed for strategy decks, technical explainers, research talks, thesis defenses, product presentations, operations reviews, management decks, and other presentation-heavy workflows where the final artifact must still behave like a real PowerPoint file.

### `word-polished-doc-collab`

`word-polished-doc-collab` turns Markdown, DOCX, and Python-generated document assets into formal Word deliverables that can survive real review. It focuses on explicit Chinese-English font pairing, heading scale, line spacing, paragraph spacing, table and figure title placement, and delivery evidence around the final DOCX export.

It is designed for contracts, policies, explanatory notes, research appendices, operating reports, board or investment committee attachments, and other Word-first workflows where the content source must remain maintainable after delivery.

### `web-demo-video-synthesis`

`web-demo-video-synthesis` produces narrated, subtitled, publishable videos in a highly automated way. It can turn articles, posts, product walkthroughs, web demos, and technical explanations into videos suitable for platforms such as TikTok, Xiaohongshu, and Bilibili.

It is designed for technical introductions, business demos, product explainers, marketing-style walkthroughs, and other short-form or medium-form presentation videos where reproducibility and iteration speed matter.

### `xhs-markdown-card-collab`

`xhs-markdown-card-collab` turns Markdown or lightly structured text into publishable Xiaohongshu image-card posts. It focuses on explicit cover metadata, stable Chinese typography, browser-based pagination, visual QA, and style variation without re-breaking proven type-size ranges.

It is designed for job posts, lab recruiting posts, research-note threads, structured commentary cards, product explainers, and other social content where the output must read cleanly on a phone and hold up as a publishable PNG bundle.

## Skill Details

### `ppt-polished-deck-collab`

`ppt-polished-deck-collab` starts by turning the user's story into a slide order, one clear message per page, and the evidence each page needs. It then generates a real editable `.pptx`, so the result remains revisable in PowerPoint after delivery.

Common tools:
- `python-pptx` for editable PowerPoint text, shapes, tables, and pages
- Native PowerPoint charts, `matplotlib` / `seaborn` / `pandas` figures, or image assets depending on the content
- PowerPoint or LibreOffice for slide-by-slide preview export
- Connector and layout checks when the deck includes flowcharts, architecture diagrams, or other editable structures

Typical workflow:
- Confirm the audience, use case, slide count, template, and style boundary
- Organize the slide outline, key message for each page, and required chart or visual assets
- Generate the editable PowerPoint, using a template or modifying an existing deck when needed
- Export slide previews and check text overflow, blurry charts, misplaced elements, and inconsistent page style
- Deliver the PowerPoint, PDF or previews, plus the review notes needed for handoff

Featured deck examples:
- Editorial native PPTX style demo: `demos/apple-editorial-ink-native/`
- Current research-report demo: `demos/apple-financial-report-review/`

Key outputs:
- `demos/apple-editorial-ink-native/final/apple_editorial_ink_native_test.pptx`
- `demos/apple-editorial-ink-native/build/rendered/contact_sheet.png`
- `demos/apple-financial-report-review/final/apple_fy2025_financial_report_review.pptx`
- `demos/apple-financial-report-review/final/apple_fy2025_financial_report_review.pdf`
- `demos/apple-financial-report-review/build/rendered/contact_sheet.png`

[![Apple FY2025 revenue and net-income page](https://raw.githubusercontent.com/Sven-LI-sankyuu/presentation-skills/main/assets/apple-financial-report-review_revenue-page.png)](demos/apple-financial-report-review/README.md)

### `word-polished-doc-collab`

`word-polished-doc-collab` starts by turning Markdown or an older Word draft into a stable structure of headings, body text, tables, images, and captions. It then generates a formal `.docx` with consistent fonts, line spacing, paragraph spacing, and caption placement, so the result can survive review and later editing.

Common tools:
- `python-docx` for generating and editing Word documents
- Direct OOXML handling when exact Chinese, Latin, and complex-script font slots matter
- Word or LibreOffice for PDF and page-preview export
- `matplotlib` / `pandas` when the document needs generated charts or tables

Typical workflow:
- Confirm the document purpose, source draft, and target formatting
- Clean up the structure of headings, body text, lists, tables, images, and captions
- Generate the `.docx`, using Chinese formal-report or English consulting-report typography when appropriate
- Export previews and check fonts, heading hierarchy, line spacing, tables, figures, headers, footers, and overall page layout
- Keep previews and review notes for formal reports so the document remains easy to revise and verify

Featured demos:
- `demos/word-lightweight-industrial-operations-brief/`
- `demos/word-refined-industrial-service-transformation/`

Key outputs:
- `demos/word-lightweight-industrial-operations-brief/out/industrial_operations_brief.docx`
- `demos/word-lightweight-industrial-operations-brief/out/preview/industrial_operations_brief.pdf`
- `demos/word-refined-industrial-service-transformation/build/docx/industrial_service_transformation.docx`
- `demos/word-refined-industrial-service-transformation/temp/qa/qa_report.md`

### `web-demo-video-synthesis`

`web-demo-video-synthesis` starts by splitting the narration into short segments, generating segment audio, and then using a timing table to drive web recording, subtitles, and final video composition. It keeps the audio, captions, recording, and final MP4 as separate outputs, so copy changes, subtitle changes, or re-recording can be done without rebuilding everything from scratch.

Common tools:
- TTS APIs or macOS `say` for segment audio
- Playwright for browser-controlled screen recording
- `ffmpeg` for combining video, audio, and subtitles
- Subtitle files and resolution settings for horizontal videos, vertical videos, and platform safe areas

Typical workflow:
- Prepare the narration and web demo
- Generate segment audio and confirm segment durations
- Record the web page according to the timing table
- Generate subtitles
- Mix audio, video, and subtitles into an MP4
- Check audio-video sync, subtitle position, image clarity, and whether key content is cropped

Featured demo:
- `demos/web-demo-video-synthesis-financial-agent/`

Public demo video:
- Bilibili: https://www.bilibili.com/video/BV1j6NwzaEDZ/

### `xhs-markdown-card-collab`

`xhs-markdown-card-collab` starts by cleaning up Markdown into phone-readable headings, lists, and emphasized points, then renders the result as vertical image cards in a real browser. It is designed for research notes, recruiting posts, product explainers, and structured commentary that should read like publishable Xiaohongshu cards with browser-rendered evidence and mobile-reading checks.

Common tools:
- Markdown and YAML front matter for body content, cover title, organization, tags, and highlights
- HTML / CSS for real browser layout
- Playwright or similar browser automation for PNG export
- Theme colors, page frame, decorations, and content grouping for style variation

Typical workflow:
- Clean up the text structure while preserving the original meaning
- Define cover information and a mobile-first page size
- Render page-by-page PNG output and an HTML preview
- Check cover density, pagination, empty space, long text wrapping, orphan headings, and mobile readability

## Repository Layout

- `ppt-polished-deck-collab/`: active polished-deck skill
- `word-polished-doc-collab/`: active Word-document collaboration skill
- `web-demo-video-synthesis/`: active web-demo-to-video skill
- `xhs-markdown-card-collab/`: active Xiaohongshu Markdown-card skill
- `demos/`: registered demo workspaces
- `old/`: archived skills and historical demos
- `assets/`: root-level preview assets used by the repository README

## Demos

- Registered polished deck demo: `demos/apple-editorial-ink-native/`
- Registered polished deck demo: `demos/apple-financial-report-review/`
- Registered Word lightweight demo: `demos/word-lightweight-industrial-operations-brief/`
- Registered Word refined demo: `demos/word-refined-industrial-service-transformation/`
- Registered web demo synthesis demo: `demos/web-demo-video-synthesis-financial-agent/`
- Registered XHS recruiting-style demo: `demos/xhs-fictional-north-quay-lab-recruiting/`
- Registered XHS research-note demo: `demos/xhs-fictional-grid-storage-research-note/`
- Registered XHS product-explainer demo: `demos/xhs-fictional-orbitops-product-explainer/`
- Registered XHS weekly-brief demo: `demos/xhs-fictional-ridership-weekly-brief/`
- Archived complex diagram demo: `old/demos/ppt-complex-diagram-collab-stock-architecture/`
- Archived polished deck demo: `old/demos/ppt-polished-deck-collab-ai-market-intelligence/`

## XHS Demo Set

The `xhs-markdown-card-collab` skill now includes four fully fictional demos under `demos/` with actual exported deliverables, so the workflow can be understood without relying on any real recruiting, research, or product copy:

- `demos/xhs-fictional-north-quay-lab-recruiting/`: institution recruiting / lab intake style, exported with `lumen`
- `demos/xhs-fictional-grid-storage-research-note/`: research-summary / framework-note style, exported with `ink`
- `demos/xhs-fictional-orbitops-product-explainer/`: product-explainer / capability-card style, exported with `clay`
- `demos/xhs-fictional-ridership-weekly-brief/`: weekly-brief / data-quick-take style, exported with `ink`

presentation-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README