Skip to content
Back to search

mck-ppt

SkillWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/likaku--mck-ppt-design-skill/badge.svg)](/listings/likaku--mck-ppt-design-skill)

HTML

<a href="/listings/likaku--mck-ppt-design-skill"><img src="/api/listings/likaku--mck-ppt-design-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "mck-ppt",
  3. "owner": { "name": "Kaku Li" },
  4. "plugins": [
  5. {
  6. "name": "mck-ppt-design",
  7. "source": "./",
  8. "description": "Consulting-style, editable PowerPoint decks: 62 layouts, native shapes, built-in QA gates.",
  9. "version": "2.4.1",
  10. "skills": ["./"],
  11. "strict": false
  12. }
  13. ]
  14. }
README.md · README · 237 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/img/hero.png" alt="MCK PPT Design Skill: consulting-grade PowerPoint, fully editable, checked by code" width="100%" />
  3. <br/>
  4. [![Stars](https://img.shields.io/github/stars/likaku/Mck-ppt-design-skill?style=for-the-badge&logo=github&color=0052D9&labelColor=051C2C)](https://github.com/likaku/Mck-ppt-design-skill/stargazers)
  5. [![Forks](https://img.shields.io/github/forks/likaku/Mck-ppt-design-skill?style=for-the-badge&logo=github&color=0052D9&labelColor=051C2C)](https://github.com/likaku/Mck-ppt-design-skill/network/members)
  6. [![License](https://img.shields.io/badge/license-Apache_2.0-0052D9?style=for-the-badge&labelColor=051C2C)](LICENSE)
  7. [![Python](https://img.shields.io/badge/python-3.8+-0052D9?style=for-the-badge&logo=python&logoColor=white&labelColor=051C2C)](https://python.org)
  8. **[Try it in 60 seconds](#-try-it-in-60-seconds)** · **[Use with your agent](#-use-it-with-your-agent)** · **[Gallery](docs/GALLERY.md)** · **[简体中文](README.zh-CN.md)** · **[Architecture](docs/ARCHITECTURE.md)**
  9. </div>
  10. <br/>
  11. > **Your AI agent writes the story. This skill draws the deck and checks the file.**
  12. > The output is a real `.pptx`: native shapes, native charts, every element editable in PowerPoint, WPS or Keynote.
  13. <div align="center">
  14. <img src="docs/img/demo.gif" alt="A prompt turns into a 6-slide deck that passes the QA gate" width="86%" />
  15. <br/><sub>Prompt to deck. The slides and the gate result are real output; the terminal is a recreation. Data in the slides is illustrative.</sub>
  16. </div>
  17. <br/>
  18. ## What the output looks like
  19. <table>
  20. <tr>
  21. <td width="33%"><img src="docs/img/showcase-1-cover.png" alt="Cover with three headline numbers"/></td>
  22. <td width="33%"><img src="docs/img/showcase-2-summary.png" alt="Executive summary with three big numbers"/></td>
  23. <td width="33%"><img src="docs/img/showcase-3-chart.png" alt="Native clustered column chart with insight panel"/></td>
  24. </tr>
  25. <tr>
  26. <td align="center"><sub><b>Cover</b><br/>numbers carry the story</sub></td>
  27. <td align="center"><sub><b>Executive summary</b><br/>result, risk, decision</sub></td>
  28. <td align="center"><sub><b>Native chart</b><br/>click it, edit the data</sub></td>
  29. </tr>
  30. <tr>
  31. <td width="33%"><img src="docs/img/showcase-4-waterfall.png" alt="Waterfall chart built from a native stacked column"/></td>
  32. <td width="33%"><img src="docs/img/showcase-5-matrix.png" alt="Impact and effort matrix with positioned items"/></td>
  33. <td width="33%"><img src="docs/img/showcase-6-roadmap.png" alt="Four-quarter roadmap with a decision gate"/></td>
  34. </tr>
  35. <tr>
  36. <td align="center"><sub><b>Waterfall</b><br/>native stacked column</sub></td>
  37. <td align="center"><sub><b>Prioritisation</b><br/>items placed by judgement</sub></td>
  38. <td align="center"><sub><b>Roadmap</b><br/>with a decision gate</sub></td>
  39. </tr>
  40. </table>
  41. <sub>All six slides come from [`examples/freeform_showcase.py`](examples/freeform_showcase.py), rendered with LibreOffice. Data is illustrative. Fonts differ slightly in PowerPoint.</sub>
  42. ## Why this exists
  43. Ask an agent for a deck and you usually get text boxes on a white page, or a picture you cannot edit. This skill gives the agent a third path.
  44. | | |
  45. |---|---|
  46. | **Real, editable `.pptx`** | Native shapes, text and charts. No screenshots. Change a number in the chart's data sheet and the bars move. |
  47. | **Consulting grammar built in** | Action titles that state the conclusion, a source line on every slide, restrained navy and grey, flat design. |
  48. | **The agent decides, Python draws** | `eng.donut(...)` costs the agent about 20 tokens; deterministic code does the rest. The author measured a 30-slide deck dropping from 40,000-60,000 output tokens to 9,000-12,000 in the v1 to v2 rewrite. |
  49. | **A gate that is code, not opinion** | `gate_check.py` writes `gate_result.json`. `passed` is computed by the script, so the agent cannot declare its own work done. It catches overflow, out-of-bounds shapes, font inconsistency and legend overflow. It does **not** catch every visual flaw: render and look before you ship. |
  50. | **Files that open cleanly** | No connectors, shadows or 3D; the post-save cleanup removes the XML that triggers PowerPoint's "repair" prompt. |
  51. | **CJK aware** | An East Asian font (KaiTi by default) is written on every text run so Chinese does not fall back to boxes where that font is installed. |
  52. ## 🚀 Try it in 60 seconds
  53. No API key, no network. Needs Python 3.8+.
  54. ```bash
  55. pip install "git+https://github.com/likaku/Mck-ppt-design-skill.git"
  56. python -m mck_ppt demo # writes mck_demo.pptx (13 slides, passes the built-in check)
  57. python -m mck_ppt layouts # lists every layout with a one-line description
  58. ```
  59. Then the freeform example that produced the slides above:
  60. ```bash
  61. git clone https://github.com/likaku/Mck-ppt-design-skill && cd Mck-ppt-design-skill
  62. python examples/freeform_showcase.py out.pptx
  63. python references/scripts/gate_check.py out.pptx . # writes gate_result.json
  64. ```
  65. > The gate scripts live in `references/scripts/` and are not part of the pip package; clone the repo to use them.
  66. ## 🤖 Use it with your agent
  67. | Agent | How |
  68. |---|---|
  69. | **Claude Code** | `git clone https://github.com/likaku/Mck-ppt-design-skill ~/.claude/skills/mck-ppt-design` and `pip install python-pptx lxml` |
  70. | **WorkBuddy / CodeBuddy** | Search `mck-ppt-design` in the skill market, or clone into `~/.workbuddy/skills/mck-ppt-design` |
  71. | **Cursor / Continue / any LLM** | Add `SKILL.md` as a project rule or paste it as context, and `pip install` the package |
  72. Then ask in plain language:
  73. > Make a 12-slide board deck on why our Q1 growth now depends on one channel. Action titles, one chart per argument, a source line on every slide.
  74. > 用麦肯锡风格做一份 15 页的年度战略汇报:先给执行摘要,再分三章,最后列出需要决策的四件事。
  75. The agent follows five stages, and two of the gates are scripts it cannot argue with:
  76. ```mermaid
  77. flowchart LR
  78. A[S1 Brief] --> B[S2 Structure<br/>outline.json]
  79. B --> C[S3 Content<br/>content.json]
  80. C --> G1{{gate_check_s3.py}}
  81. G1 -->|pass| D[S4 Render]
  82. D --> G2{{gate_check.py}}
  83. G2 -->|pass| E[S5 Deliver]
  84. G1 -.->|fail| C
  85. G2 -.->|fail| D
  86. ```
  87. Details in [docs/HARNESS.md](docs/HARNESS.md).
  88. ## Two ways to build a deck
  89. | | **Layout methods** | **Free composition** |
  90. |---|---|---|
  91. | What | `eng.cover()`, `eng.table_insight()`, `eng.donut()` and 59 more | Drawing primitives and native charts, as in `examples/freeform_showcase.py` |
  92. | Strength | Fast, consistent, hard to break | More visual: big numbers, native charts, custom composition |
  93. | Risk | Fixed text boxes: long text overflows, the layout cannot bend | Needs a render-and-look pass; there is no template to lean on |
  94. | Use when | Many slides, tight deadline, uniform look | The deck has to persuade, or a layout does not fit the message |
  95. Both go through the same cleanup and the same gate. In our own tests the free-composition version of the same content looked clearly better; the layout version is faster.
  96. ```python
  97. from mck_ppt import MckEngine
  98. from mck_ppt.constants import *
  99. eng = MckEngine(total_slides=3)
  100. eng.cover(title='Q1 strategy review', subtitle='Board presentation', date='2026')
  101. eng.table_insight(
  102. title='Three shifts are restructuring the market',
  103. headers=['Dimension', 'Before', 'After'],
  104. rows=[['Distribution', 'Offline-first', 'Digital-first'], ['Pricing', 'Cost-plus', 'Value-based']],
  105. insights=['Digital channels now drive 60% of acquisition', 'Value pricing unlocks about 3x margin'])
  106. eng.closing(title='Thank you')
  107. eng.save('deck.pptx')
  108. ```
  109. <details>
  110. <summary><b>All 62 layout methods</b></summary>
  111. <br/>
  112. | Category | Layouts |
  113. |---|---|
  114. | **Structure** | `cover`, `section_divider`, `toc`, `agenda`, `appendix_title`, `closing` |
  115. | **Key numbers** | `big_number`, `two_stat`, `three_stat`, `metric_cards`, `scorecard`, `kpi_tracker`, `rag_status`, `data_table`, `harvey_ball_table` |
  116. | **Frameworks** | `table_insight`, `matrix_2x2`, `pyramid`, `process_chevron`, `temple`, `swot`, `value_chain`, `risk_matrix`, `stakeholder_map`, `decision_tree` |
  117. | **Comparison** | `side_by_side`, `before_after`, `pros_cons`, `metric_comparison` |
  118. | **Narrative** | `executive_summary`, `key_takeaway`, `four_column`, `two_column_text`, `case_study`, `action_items`, `checklist`, `quote`, `meet_the_team`, `numbered_list_panel`, `icon_grid` |
  119. | **Timeline** | `timeline`, `vertical_steps` |
  120. | **Charts** | `donut`, `waterfall`, `line_chart`, `pareto`, `bubble`, `grouped_bar`, `stacked_bar`, `horizontal_bar`, `stacked_area`, `multi_bar_panel`, `dashboard_kpi_chart`, `dashboard_table_chart` |
  121. | **Image layouts** | `content_right_image`, `three_images`, `image_four_points`, `full_width_image`, `case_study_image`, `quote_bg_image`, `goals_illustration`, `two_col_image_grid` |
  122. Signatures: `python -m mck_ppt layouts`, or [docs/GALLERY.md](docs/GALLERY.md).
  123. </details>
  124. <details>
  125. <summary><b>Guard rails enforced in code</b></summary>
  126. <br/>
  127. - No connectors (they trigger PowerPoint repair prompts); lines are thin rectangles.
  128. - Shadows, 3D and `p:style` are stripped after save.
  129. - Same-row shapes keep the same font size; text never touches separator lines.
  130. - Circular charts use native `BLOCK_ARC`, 3-4 shapes instead of thousands of rectangles.
  131. - Every CJK run gets an East Asian font.
  132. Full list: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
  133. </details>
  134. <details>
  135. <summary><b>Known limitations (read before you rely on it)</b></summary>
  136. <br/>
  137. - **Gate is not a visual review.** It misses some problems, for example a long title that wraps onto the subtitle. Render the deck and look at it.
  138. - **Layout methods use fixed text boxes.** Long text overflows; some layouts are sparse (for instance `big_number`).
  139. - **Preview needs LibreOffice.** `scripts/render_preview.py` uses LibreOffice and poppler. Install KaiTi and Arial for faithful output; without KaiTi the text falls back to another font and wrapping changes.
  140. - **Not supported:** SmartArt, animations, slide masters.
  141. - **Layout QA is not clean yet.** `python run_qa_tests.py` still reports layout errors on several layouts; they are tracked for v2.4.x.
  142. - **AI cover image** needs a Tencent Cloud key and extra dependencies (`pip install ...[cover-image]`).
  143. </details>
  144. <details>
  145. <summary><b>FAQ</b></summary>
  146. <br/>
  147. **Does it open in WPS and Keynote?** The file uses standard shapes and charts. We test mainly in PowerPoint and LibreOffice; please open an issue if you see differences.
  148. **Chinese text looks different from the screenshots.** The default East Asian font is KaiTi. If it is not installed, your viewer substitutes another font. Install KaiTi, or change the font in `mck_ppt/constants.py`.
  149. **Can I change the colors?** Yes. Palette constants are in `mck_ppt/constants.py`.
  150. **Do I need an API key?** No, except for the optional AI cover image.
  151. </details>
  152. ## Roadmap
  153. - [x] `python -m mck_ppt demo`, `layouts`, `pip install` from GitHub
  154. - [x] Free-composition example with native charts
  155. - [ ] Publish to PyPI (`pip install mck-ppt`)
  156. - [ ] Render-and-check step in the gate (catch text overlapping other shapes)
  157. - [ ] Native chart helpers in the engine (clustered, stacked, waterfall)
  158. - [ ] Theme switch (navy / graphite / warm)
  159. - [ ] Import an existing `.pptx` and restyle it
  160. Want something? [Request a layout](https://github.com/likaku/Mck-ppt-design-skill/issues/new?template=layout_request.yml) · [Show a deck you built](https://github.com/likaku/Mck-ppt-design-skill/issues/new?template=showcase.yml)
  161. ## Community
  162. - **Made a deck with it?** [Show it](https://github.com/likaku/Mck-ppt-design-skill/issues/new?template=showcase.yml). Good ones get featured here.
  163. - **Bug or broken layout?** [Open an issue](https://github.com/likaku/Mck-ppt-design-skill/issues/new?template=bug_report.yml) with the layout name, a 5-line repro and a screenshot.
  164. - **Chat:** [Discord](https://discord.gg/SaFybFAT) · WeChat group (200+ members): add `Kashinmoto`
  165. - **Contribute:** see [CONTRIBUTING.md](CONTRIBUTING.md)
  166. If it saved you an evening, a star helps other people find it.
  167. <div align="center">
  168. [![Star History Chart](https://api.star-history.com/svg?repos=likaku/Mck-ppt-design-skill&type=Date)](https://star-history.com/#likaku/Mck-ppt-design-skill&Date)
  169. </div>
  170. ---
  171. <div align="center"><sub>Apache 2.0 · © 2024-2026 <strong>Kaku Li</strong> · <a href="NOTICE">NOTICE</a> · <a href="CHANGELOG.md">Changelog</a></sub></div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.