プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Mck-ppt-design-skill Skill

リポジトリ ↗

作者:likaku★ 3461 個の skill

インストール

What it does

Consulting firm-style PowerPoint design system for AI agents. 70 layout patterns, flat design, python-pptx. 麦麸风格PPT设计系统。

  • Connects Instruction files the AI reads
  • Account or key Not confirmed (README mentions a key or .env file)
  • Category デザインと Web
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/likaku-mck-ppt-design-skill.svg)](https://mcp.popnx.com/en/skills/likaku-mck-ppt-design-skill)

一緒に使える

同じ作業で AI をサービスにつなぐ MCP

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター一昨日更新

MCP · サービスにつなぐパソコンでもクラウドでも✓ 提供元 · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

作者:nteract広く使われている↓ 8456/週★ 2717昨日更新

MCP · サービスにつなぐパソコンでもクラウドでも

似た Skill

同じ種類の作業。Skill 一覧と同じ並び

似たものと比べる
これ
Mck-ppt-design-skill
impeccablediagram-designfrontend-slidesguizang-ppt-skill
作者likakupbakauscathrynlaveryzarazhangruiop7418
Skill 数11111
GitHub スター346113,04268,29632,57930,091
最終コード更新2026年11月3日2026年11月19日2026年11月19日2026年6月24日2026年10月30日
ライセンスApache-2.0Apache-2.0MITMITAGPL-3.0

likaku による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません

Skill と MCP の違い

MCP = 手

AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。

Skill = 手順書

作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。

重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。

使えるアプリ

Claude CodeCursor

提供元の README と repo のフォルダから判断

インストール

Is it safe?

  • Who made it

    GitHub account likaku (person), 15 years old

  • Use and upkeep

    ★ 346 stars, few users so far · code last changed 2026年11月3日

  • Any scripts?

    22 scripts that can run on a computer: scripts/gh_setup.sh, examples/freeform_showcase.py, examples/minimal_example.py, examples/staircase_civilization.py and 18 more

  • Uses the internet?

    Scripts that go online: mck_ppt/cover_image.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 4922199 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

まず:どの AI を使っていますか

使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (990). Use "Let the AI install it" instead

Option 1Claude Code にインストールしてもらう

この文をコピーして Claude Code のチャットに貼り付けます

Where to install

コマンドを確認中 · 確認が通るとコピーボタンが出ます

コマンドを確認中 · 確認が通るとコピーボタンが出ます

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code を開き直し、/Mck-ppt-design-skill と入力するか関連する作業を頼むと Claude が自動で使います

Checked against official docs 2026年11月12日 · Source: code.claude.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.claude/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

  3. Claude Code を開き直し、/Mck-ppt-design-skill と入力するか関連する作業を頼むと Claude が自動で使います

自分でインストールした Skill は ChatGPT デスクトップアプリ、Codex CLI、IDE の Codex 拡張機能で使えます · Web 版とモバイル版の ChatGPT では自分でインストールした Skill は使えず、ディレクトリのプラグインに含まれる Skill だけが使えます

ChatGPT デスクトップアプリ

ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます

Option 1ChatGPT にインストールしてもらう

ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます

Where to install

コマンドを確認中 · 確認が通るとコピーボタンが出ます

コマンドを確認中 · 確認が通るとコピーボタンが出ます

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2自分でフォルダを置く

mck-ppt-design フォルダを ~/.agents/skills/mck-ppt-design に置きます

~ はホームフォルダ($HOME)です

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

インストールしたあと

  • ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
  • 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
  • Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Web 版とモバイル版の ChatGPT

自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます

この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Option 1Codex にインストールしてもらう

この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます

Where to install

コマンドを確認中 · 確認が通るとコピーボタンが出ます

コマンドを確認中 · 確認が通るとコピーボタンが出ます

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

  3. Codex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します

Option 1Cursor にインストールしてもらう

この文をコピーして Cursor のチャットに貼り付けます

Where to install

コマンドを確認中 · 確認が通るとコピーボタンが出ます

コマンドを確認中 · 確認が通るとコピーボタンが出ます

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor の Agent チャットで / を入力し Mck-ppt-design-skill を選ぶ

Checked against official docs 2026年11月12日 · Source: cursor.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.cursor/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

  3. Cursor の Agent チャットで / を入力し Mck-ppt-design-skill を選ぶ

Option 1Let the AI install it

Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · Copy this sentence into the app’s chat

Where to install

コマンドを確認中 · 確認が通るとコピーボタンが出ます

コマンドを確認中 · 確認が通るとコピーボタンが出ます

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。

GitHub で見る ↗

2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認

元の SKILL.md を見る

以下は提供元の repo の文章で、PopNx MCP の指示ではありません

最初の 8,000 文字を表示 · GitHub で全文を開く

---
name: mck-ppt-design
description: >-
  Create professional, consultant-grade PowerPoint presentations from scratch
  using MckEngine (python-pptx wrapper) with McKinsey-style design. Use when
  user asks to create slides, pitch decks, business presentations, strategy
  decks, quarterly reviews, board meeting slides, or any professional PPTX.
  AI calls eng.cover(), eng.donut(), eng.timeline() etc — 62 active layout methods
  across 8 categories (structure, data, framework, comparison, narrative,
  timeline, team, charts, images, advanced viz, dashboards, visual storytelling),
  consistent typography, zero file-corruption issues, BLOCK_ARC native shapes
  for circular charts (donut, pie, gauge), production-hardened guard rails
  for spacing, overflow, legend consistency, title style uniformity,
  dynamic sizing for variable-count layouts, horizontal item overflow
  protection, chart rendering, and
  AI-generated cover images via Tencent Hunyuan 2.0 with professional cutout,
  cool grey-blue tint, and McKinsey-style Bézier ribbon decoration.
---

# McKinsey PPT Design — Harness Framework

> **Version**: 2.4.1 · **Engine**: MckEngine (python-pptx) · **Author**: [likaku](https://github.com/likaku/Mck-ppt-design-skill)
>
> **Required tools**: Read, Write, Bash · **Requires**: `pip install python-pptx lxml`

---

## 常见崩坏模式(每次生成前必读,先于 HARD RULES)

> 告诉 AI 要做什么效果一般,告诉它前人最容易在哪里塌效果更好。
> 以下三种反模式均已在真实执行中被验证,每次必须主动警惕。

### 反模式 1:口头宣布"门禁通过"(最常见)

**错误做法**:
> 「S4 QA 共 7 个 errors,判断均为 engine 设计行为,门禁通过,进入 S5」

**问题所在**:`passed` 是由 AI 口头判断的,不是由程序派生的。无论理由多充分,这句话都是 AI 在给自己写完成证书。

**正确做法**:
1. 执行 `python references/scripts/gate_check.py <pptx路径> <项目目录>`
2. 读取 `<项目目录>/gate_result.json`
3. 只有 `gate_result.json` 中 `"passed": true` 时,才能进入 S5
4. 如果 `"passed": false`,修复 `user_code_errors` 列表中的问题,重新渲染,再次执行 gate_check

---

### 反模式 2:S3 门禁"脑子里过一遍"就算通过

**错误做法**:
> 「S3 内容门禁预检:API 格式正确,字数在限制内,通过,进入 S4」(没有执行任何代码)

**问题所在**:今天真实发生的 3 个 API 格式错误(`four_column`/`matrix_2x2`/`executive_summary` 参数格式),靠脑子过是过不出来的,必须靠代码检查。

**正确做法**:
1. 执行 `python references/scripts/gate_check_s3.py <content.json路径> <项目目录>`
2. 读取 `<项目目录>/gate_s3.json`
3. 只有 `"passed": true` 时,才能进入 S4
4. 如果有 `fail` 项,修正 `content.json`,重新执行 gate_check_s3

---

### 反模式 3:engine_bug 分类作为软话逃生口

**错误做法**:
> 「peer_font_inconsistency 是 engine 内部设计行为,不是用户代码问题,可以放行」

**问题所在**:这个分类本身是正确的,但由 AI 在对话里口头做出,等于把豁免权交给了 AI 自己——而 AI 有动机让自己通过。

**正确做法**:
`gate_check.py` 里有硬编码的 `ENGINE_BUG_WHITELIST` 枚举。只有在白名单里的 error category,才会被豁免。白名单是代码,不是 AI 的判断。如果你认为某类 error 应该加入白名单,修改 `gate_check.py` 里的枚举,而不是口头声明豁免。

---

## HARD RULES(必须遵守,不可绕过)

1. **每次生成必须走五阶段流程**,不允许"一句话直接生成"跳过前置阶段
2. **TaskCreate 驱动进度**:开始前创建5个 task,每阶段完成后立即 TaskUpdate completed
3. **按需加载上下文**:每个阶段只读对应文件,不要全量加载旧版 SKILL.md 里的内容
4. **门禁必须机读化**:S3 和 S4 门禁必须执行对应的 gate_check 脚本,读 JSON 结果,不得口头判断
5. **Self-Refinement 必做**:每次修正 pattern-level 问题后,写入 `experiences/` 对应文件
6. **引擎导入**:已 `pip install mck-ppt` 则直接 `from mck_ppt import MckEngine`;否则把本 skill 目录加入 `sys.path`(WorkBuddy 默认 `~/.workbuddy/skills/mck-ppt-design`,Claude Code 默认 `~/.claude/skills/mck-ppt-design`)。不确定时先跑 `python -m mck_ppt demo` 验证环境

---

## 知识路由(上下文加载索引)

> **在每个阶段开始时,读对应文件**。不要一次性全读。

| 阶段 | 必须读 | 说明 |
|------|--------|------|
| S1 需求 | `references/team/brand-guide.md` | 了解设计约束 |
| S2 结构 | `references/framework/engine-api.md` + `references/layout-matrix.yaml` | 版式选择和能力边界 |
| S3 内容 | `references/framework/guard-rails.md` + `experiences/*.md`(存在时)| 防溢出规则 + 历史踩坑 |
| S4 渲染 | 用到的 `references/layouts/*.md`(只读实际用到的版式)| 版式实现细节 |
| S5 交付 | 无 | — |

**完整路由表**:`references/INDEX.md`

---

## 五阶段生成流程

```
┌─────────┐   ┌─────────────┐   ┌─────────────┐   ┌──────────────┐   ┌──────────┐
│ S1 需求  │──▶│ S2 结构 ⭐   │──▶│ S3 内容 ⭐   │──▶│ S4 渲染+QA ⭐⭐│──▶│ S5 交付   │
│ brief.md│   │ outline.json│   │content.json │   │  .pptx       │   │ + 沉淀   │
└─────────┘   └─────────────┘   └─────────────┘   └──────────────┘   └──────────┘
                    ⭐ = 门禁(FAIL 则在本阶段修正,不得跳过)
    S3/S4 门禁必须运行 gate_check 脚本,读 JSON 结果 — 不得口头宣布通过
```

### Stage 1: 需求定义

**读文件**:`references/team/brand-guide.md`

**收集信息**:
- 受众(职位/决策角色)
- 目标(决策/汇报/说服)
- 时长(分钟数 → 约 1 分钟/页)
- 关键信息(最多 5 条核心 message)
- 数据来源(有哪些数据可用)

**产出**:在工作目录创建 `ppt-project-{slug}/brief.md`

**门禁**:`audience` + `goal` + `key_messages` 三项非空(AI 自评即可)

---

### Stage 2: 结构设计

**读文件**:`references/framework/engine-api.md`, `references/layout-matrix.yaml`

**任务**:
1. 根据时长确定页数(1分钟/页)
2. 为每张幻灯片选定 `layout`(查 engine-api.md 速查表)
3. 每页写一句核心 `key_point`(完整句子,不是标签)
4. 确认版式在能力边界内(查 layout-matrix.yaml)

**产出**:`ppt-project-{slug}/outline.json`

```json
{
  "brief": {"audience": "董事会", "goal": "战略汇报", "duration_minutes": 15},
  "slides": [
    {"idx": 1, "layout": "cover", "title": "Q1 2026 战略回顾", "key_point": ""},
    {"idx": 2, "layout": "toc", "title": "目录", "key_point": ""},
    {"idx": 3, "layout": "table_insight", "title": "市场格局三大转变驱动战略重构", "key_point": ""}
  ]
}
```

**⭐ 门禁 S2**(AI 自评):
- [ ] `cover` 幻灯片存在
- [ ] 幻灯片数量在时长约束内(`count <= duration_minutes * 1.2`)
- [ ] 所有 layout 在 `layout-matrix.yaml` 中有定义
- [ ] Action Title 均为完整句子(len > 10,包含动词)
- [ ] `two_column_text` 数量 ≤ 1

---

### Stage 3: 内容填充

**读文件**:`references/framework/guard-rails.md`, `experiences/*.md`(全部存在的文件)

**任务**:
1. 为每张幻灯片填充具体文案、数字、图表数据
2. 确保每页有 `source` 出处
3. 按 `layout-matrix.yaml` 的 `char_budget` 控制文字量

**产出**:`ppt-project-{slug}/content.json`

**⭐ 门禁 S3**(必须机读化,不得 AI 自评):

```bash
python ~/.workbuddy/skills/mck-ppt-design/references/scripts/gate_check_s3.py \
    <项目目录>/content.json  <项目目录>
```

读取 `<项目目录>/gate_s3.json`:
- `"passed": true` → 进入 S4
- `"passed": false` → 修正 `content.json` 中 `fail_items` 列出的问题,重新执行

---

### Stage 4: 渲染 + QA

**读文件**:用到的版式对应的 `references/layouts/*.md`

**任务**:
1. 根据 `content.json` 生成 Python 渲染脚本
2. 执行脚本生成 `.pptx`
3. 运行 QA 门禁脚本

**⭐⭐ 门禁 S4**(必须机读化,不得口头宣布通过):

```bash
python ~/.workbuddy/skills/mck-ppt-design/references/scripts/gate_check.py \
    <pptx路径>  <项目目录>
```

读取 `<项目目录>/gate_result.json`:
- `"passed": true` → 进入 S5
- `"passed": false` → 查看 `user_code_errors`,修复渲染代码,重新渲染,再次执行

**注意**:`engine_bug` 类 errors(`peer_font_inconsistency` 等白名单条目)由脚本自动豁免,不需要 AI 口头判断。

**产出**:`<项目目录>/gate_result.json` + `.pptx`

---

### Stage 5: 交付 + Self-Refinement

**任务**:
1. 读取 `gate_result.json` 确认 `passed: true`(不得在无此文件时声称通过)
2. 交付 `.pptx` 文件
3. **Self-Refinement**:判断本次是否有 pattern-level 修正

**⭐ Self-Refinement 协议**:

```
修正后判断:
  ONE-TIME(单次特定调整)→ 不需要沉淀
  PATTERN(跨 deck 可重现的问题)→ 必须写入 experiences/
    - 溢出类 → experiences/overflow.md
    - 图表限制 → experiences/chart-limits.md
    - 版式踩坑 → experiences/layout-pitfalls.md
    - 中文渲染 → experiences/cjk-issues.md

格式:
  ## Experience NNN: {title}
  **Date**: YYYY-MM-DD
  **Problem**: ...
  **Root Cause**: ...
  **Fix**: ...
  **Rule**: ...(门禁层面如何预防)
```

---

## Fast Track(简单需求跳过 S2/S3 门禁)

满足**全部**条件时,AI 可跳过 S2 结构评审和 S3 内容审查:
- 总页数 ≤ 5
- 无数据图表(donut/bar/table 类)
- 用户明确表达"快速"/"马上要"/"简单"

**仍然必须**:S1 需求收集 + S4 QA 门禁(gate_check.py 脚本执行)+ S5 交付

---

## Checkpoint / 断点恢复

当用户说"继续做那个 PPT"时:

```python
import os, json, glob

projects = glob.glob('ppt-project-*/')
for proj in projects:
    brief   = os.path.exists(f'{proj}brief.md')
    outline = os.path.exists(f'{proj}outline.json')
    content = os.path.exists(f'{proj}content.json')
    gate_s3 = os.path.exists(f'{proj}gate_s3.json')
    gate_s4 = os.path.exists(f'{proj}gate_result.json')
    pptx    = bool(glob.glob(f'{proj}*.pptx'))

    if not brief:           stage = 1
    elif not outline:       stage = 2
    elif not content:       stage = 3
    elif not gate_s3:       stage = '3-gate'   # content 有了但 gate 还没跑
    elif not pptx:          stage = 4
    elif not gate_s4:       stage = '4-gate'   # pptx 有了但 gate 还没跑
    else:                   stage = 5

    print(f"项目 {proj}: 当前处于 Stage {stage}")
```

---

## MckEngine 快速模板

```python
import sys, os
# pip install mck-ppt 后可省略下面两行;skill 目录按实际安装位置调整
sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills/mck-ppt-design'))
from mck_ppt import MckEngine
from mck_ppt.constants import 

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

GitHub の情報

GitHub スター
346
提供元
likaku
ライセンス
Apache-2.0
最終コード更新
2026年11月3日
repo 内の SKILL.md(翻訳版とテンプレートを含む)
1
トピック
agent-skill, ai-skill, ai-skills, ba, business, claude, claude-code, claude-skill, consulting, design-system, mckinsey, pitch-deck