aktsmm

powerpoint-automation

4
0
# Install this skill:
npx skills add aktsmm/Agent-Skills --skill "powerpoint-automation"

Install specific skill from multi-skill repository

# Description

Create professional PowerPoint presentations from various sources including web articles, blog posts, and existing PPTX files. Ideal for tech presentations, reports, and documentation.

# SKILL.md


name: powerpoint-automation
description: Create professional PowerPoint presentations from various sources including web articles, blog posts, and existing PPTX files. Ideal for tech presentations, reports, and documentation.
license: Complete terms in LICENSE.txt
metadata:
author: yamapan (https://github.com/aktsmm)


PowerPoint Automation

AI-powered PPTX generation using Orchestrator-Workers pattern.

When to Use

  • Convert web articles/blog posts to presentations
  • Translate English PPTX to Japanese
  • Create presentations using custom templates
  • Generate technical presentations with code blocks

Quick Start

From Web Article:

Create a 15-slide presentation from: https://zenn.dev/example/article

From Existing PPTX:

Translate this presentation to Japanese: input/presentation.pptx

Workflow

TRIAGE β†’ PLAN β†’ PREPARE_TEMPLATE β†’ EXTRACT β†’ TRANSLATE β†’ BUILD β†’ REVIEW β†’ DONE
Phase Script/Agent Description
EXTRACT extract_images.py Content β†’ content.json
BUILD create_from_template.py Generate PPTX
REVIEW PPTX Reviewer Quality check

Key Scripts

β†’ references/SCRIPTS.md for complete reference

Script Purpose
create_from_template.py Generate PPTX from content.json (main)
reconstruct_analyzer.py Convert PPTX β†’ content.json
extract_images.py Extract images from PPTX/web
validate_content.py Validate content.json schema
validate_pptx.py Detect text overflow

content.json (IR)

All agents communicate via this intermediate format:

{
  "slides": [
    { "type": "title", "title": "Title", "subtitle": "Sub" },
    { "type": "content", "title": "Topic", "items": ["Point 1"] }
  ]
}

β†’ references/schemas/content.schema.json

Templates

Template Purpose Layouts
assets/base_template.pptx Full-featured (English) 11 layouts
assets/template.pptx Legacy (Japanese names) 4 layouts

Agents

β†’ references/agents/ for definitions

Agent Purpose
Orchestrator Pipeline coordination
Localizer Translation (EN ↔ JA)
PPTX Reviewer Final quality check

Design Principles

  • SSOT: content.json is canonical
  • SRP: Each agent/script has one purpose
  • Fail Fast: Max 3 retries per phase
  • Human in Loop: User confirms at PLAN phase

References

File Content
SCRIPTS.md Script documentation
USE_CASES.md Workflow examples
agents/ Agent definitions
schemas/ JSON schemas

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.