# clean-slides-Abdelhamid > [CleanSlides_SKILL.md](https://github.com/user-attachments/files/27374537/CleanSlides_SKILL.md) - Skill: `abomalek1986/clean-slides-abdelhamid` (Agent Skill) - Install (CLI): `npx skillmds@latest add abomalek1986/clean-slides-abdelhamid` - Raw SKILL.md: https://api.skillmd.com/api/skills/abomalek1986/clean-slides-abdelhamid/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: AboMalek1986 (https://skillmd.com/u/abomalek1986) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/abomalek1986/clean-slides-abdelhamid --- [CleanSlides_SKILL.md](https://github.com/user-attachments/files/27374537/CleanSlides_SKILL.md) --- name: Clean Slides -Abdelhamid description: Inspect, edit, and generate clean consulting-style PowerPoint slides from YAML. Minimal information-dense tables with no graphics or effects — the way McKinsey slides are actually written. Use when asked to create structured argument slides, comparison tables, RAG status slides, or any text-heavy consulting deck. Built by an ex-McKinsey consultant. author: Abdelhamid Fahim version: 1.0.0 source: https://github.com/tmustier/clean-slides license: MIT --- # Clean Slides — PowerPoint Skill > **Adapted by Abdelhamid Fahim** (GCC Marketing Manager, Pharmalink | Dubai, UAE) > from the open-source project [`tmustier/clean-slides`](https://github.com/tmustier/clean-slides) > by Thomas Mustier (ex-McKinsey consultant) — MIT License. > > Part of the [claude-skills](https://github.com/AboMalek1986/claude-skills) collection: > open-source AI tools converted into reusable Claude SKILL.md files. --- ## What this skill does Generates clean, consulting-grade `.pptx` table slides from YAML specs using the `pptx` CLI. No graphics, no effects — just structured thinking in a clear visual format. Built by someone who spent 6 years writing slides at McKinsey. **The philosophy:** A good slide is a unit of structured argumentation that happens to be visual. You think the thoughts, Claude structures them, the tool handles formatting. **Trigger this skill when the user says:** - "make me a clean consulting slide" - "create a structured argument slide / comparison table" - "build a RAG status table / assessment table" - "generate a table slide from this data" - "edit / inspect / fix my PowerPoint file" - "create slides with no graphics, just structured text" - Any request to produce minimal information-dense `.pptx` slides **Use this instead of mckinsey-pptx when:** - The slide is primarily a table or structured text (not charts/visuals) - The user wants argument-driven slides, not visual decks - You need to inspect or edit an existing `.pptx` file --- ## Installation (one time) ```bash # Clone into your agent skills directory git clone https://github.com/tmustier/clean-slides cd clean-slides pip install -e . --break-system-packages # Initialize with bundled example template pptx init # Or with your own corporate template pptx init -t path/to/your-template.pptx ``` Verify: ```bash pptx --help ``` --- ## Core workflow ### 1. Inspect → Edit → Verify ```bash # Inspect — progressive drill-down pptx show deck.pptx # slide list pptx show deck.pptx 3 # shapes on slide 3 pptx show deck.pptx 3 5 # full detail for shape 5 # Edit pptx edit deck.pptx 3 5 "New text" --out edited.pptx # Verify visually pptx render edited.pptx 3 --out images/ ``` ### 2. Generate table slides from YAML Write a YAML spec, run one command, get a `.pptx`: ```bash pptx generate slide.yaml -o output.pptx pptx generate slide1.yaml slide2.yaml slide3.yaml -o output.pptx ``` --- ## YAML spec format ```yaml title: The potential scale of tokenization hinges on multiple factors. subtitle: Three adoption scenarios, 2030, nonexhaustive table: rows: 4 cols: 4 has_col_header: true has_row_header: true col_headers: ["Slower adoption", "Base scenario", "Accelerated adoption"] col_header_color: accent1 column_widths: [0, 1, 1, 1] row_headers: - "Regulation" - "Infrastructure" - "Market demand" - "Risk" cells: - ["Regulatory challenges remain high", "Regional disparities exist", "Permissive regulation"] - ["Inadequate infrastructure", "Infrastructure reaches maturity", "Institutional-grade maturity"] - ["No solution to cold start problem", "Some assets tokenized at scale", "Cold start problem overcome"] - ["Systemic risk event occurs", "Limited security issues", ""] ``` **Top-level YAML keys:** | Key | Purpose | |-----|---------| | `title` | Required — fills title placeholder | | `subtitle` | Subtitle placeholder | | `tracker` | On-page tracker/breadcrumb | | `slide_layout` | Layout name e.g. `"Default"`, `"2/3"`, `"3/4"` | | `content_layout` | `default` or `full` | | `sidebar` | Text for secondary area in split layouts | --- ## Table features ### Inline formatting ``` **bold text** → bold *italic text* → italic [link text](url) → clickable hyperlink ``` ### Row overrides ```yaml row_overrides: 0: # first data row align: ctr anchor: ctr bold: true color: accent1 size: 20 ``` ### Column widths ```yaml column_widths: equal # equal columns column_widths: [0, 1, 2, 1] # manual proportions (0 = auto row header) ``` ### Icon indicators (RAG status) Use `🟢`, `🟡`, `🔴` directly in cell text for traffic-light status indicators. ### Sidebar (split layouts) ```yaml slide_layout: "2/3" sidebar: - paragraphs: - runs: - text: "Key takeaway" bold: true ``` --- ## All CLI commands | Command | Purpose | |---------|---------| | `pptx generate -o out.pptx` | Generate slides from YAML | | `pptx charts spec.json output.pptx` | Generate bar/stacked/waterfall charts (alpha) | | `pptx validate ` | Check YAML against schema | | `pptx verify ` | Check sizing and overflow | | `pptx show [slide] [shape]` | Inspect slides and shapes | | `pptx layouts ` | Show template layouts and content areas | | `pptx theme ` | Show colour scheme | | `pptx edit ` | Edit shape text | | `pptx batch edits.json` | Batch text edits | | `pptx insert [--at N]` | Merge slides from another file | | `pptx render [--out DIR]` | Render slides to PNG | | `pptx crop L T R B` | Crop a rendered PNG | | `pptx add-slide ` | Add a blank slide | | `pptx delete-slide ` | Delete a slide | | `pptx delete-shape ` | Delete a shape | | `pptx init [-t template]` | Bootstrap `.clean-slides/` project | | `pptx init-config