CSA PPT Plugin
All-in-one presentation toolkit for Cloud Solution Architects (Azure / AWS / GCP).
Works with Claude Code, Cursor, GitHub Copilot CLI, OpenAI Codex CLI, Windsurf, and OpenCode.
What's Inside
Skills (1 orchestrator + 5 sub-skills + 1 utility)
| Skill | Description |
|---|
| csa-ppt | Smart orchestrator — analyzes your request and routes to the best tool chain |
| azure-diagrams | 700+ cloud icons (Azure/AWS/GCP), architecture diagrams, swimlane flows, ERDs, timelines |
| excalidraw-diagram | Hand-drawn style diagrams for brainstorming and conceptual visuals |
| frontend-slides | Zero-dependency HTML presentations, great for Chinese content and code |
| pptx | Full OOXML-level PowerPoint creation and editing |
| skywork-ppt | Quick PowerPoint generation, template-based creation, and slide operations |
| planning-with-files | Task planning with file-based progress tracking for multi-slide decks |
Sub-Agents (6 agents)
The orchestrator 按需调度 sub-agents — not every agent is used every time. The orchestrator
decides based on deck size and complexity:
| Agent | Phase | Role | When Dispatched |
|---|
| Research Agent | Phase 1 | Gathers cloud docs (Azure/AWS/GCP), features, case studies, industry context | Topics need web research |
| Diagram Agent | Phase 2 | Generates architecture diagrams and technical visuals | Deck includes architecture diagrams |
| Slide Builder Agent | Phase 3 | Builds individual slides, smart format selection per slide (parallelizable) | Large decks (10+ slides) |
| Assembly Agent | Phase 4 | Normalizes mixed formats + merges slides + diagrams into final deck | Multiple builders produced separate files |
| Review Agent | Phase 5 | Quality review across 7 dimensions, max 2 rounds | Always for 5+ slide decks |
| Fix Agent | Phase 5 | Applies targeted fixes from the review report | Review found issues |
Dispatch strategy by deck size:
| Deck Size | Orchestrator Does | Sub-Agents Handle |
|---|
| Small (< 5 slides) | Everything directly, quick self-check | — |
| Medium (5–10 slides) | Phase 1, 2, 4 | Slide Builder (Phase 3), Review + Fix (Phase 5) |
| Large (10+ slides) | Coordination only | All 6 agents, Slide Builders run in parallel |
Workflow
Plan → Style Contract → Research → Diagrams → Slides → Assembly → Review → Fix → Deliver
Phase 1 Phase 2 Phase 3 Phase 4 Phase 5
Each presentation follows a 5-phase workflow:
- Plan — Break the deck into tasks (one per slide/chapter)
- Define Style — Lock colors, fonts, layout rules into a Style Contract
- Execute — Research + diagrams + slides (parallel where possible)
- Assemble — Normalize mixed intermediate formats + combine into final .pptx or HTML
- Review & Fix — Independent quality check + fix loop (max 2 rounds)
Smart Intermediate Format Selection
Slide Builder Agents choose the best intermediate format per-slide based on content — not
forced to match the final output format:
| Content | Intermediate Format | Why |
|---|
| Simple bullets, English content | .pptx (python-pptx) | Direct, no conversion overhead |
| Diagram-only slides | .pptx (python-pptx) | Simple image embed |
| Chinese-heavy (中文为主) | .html | Better CJK font rendering |
| Code blocks with syntax highlighting | .html | Native code rendering |
| Complex multi-column layouts | .html | CSS flexbox/grid flexibility |
The Assembly Agent handles the format mix — normalizing all slides to the target format
before merging into the final deck.
Supported Scenarios
- Customer Solution Demos — Architecture diagrams + polished .pptx decks
- Internal Tech Sharing — HTML slides with code syntax highlighting
- Workshops / Hands-on Labs — Step-by-step interactive presentations
- Architecture Reviews (CAF/WAF/Well-Architected) — Assessment decks with as-is/to-be diagrams
- Template Filling — Fill company/event templates while preserving branding
Installation
Claude Code (Primary)
# Via marketplace (recommended)
/plugin marketplace add huqianghui/csa-ppt-plugin
/plugin install csa-ppt@csa-skills
# Or load directly for testing
claude --plugin-dir /path/to/csa-ppt-plugin
Cursor
Clone to your project and Cursor auto-discovers .cursor-plugin/plugin.json:
git clone https://github.com/huqianghui/csa-ppt-plugin.git .cursor-plugins/csa-ppt
Or add individual skill paths in Cursor Settings > Skills.
GitHub Copilot CLI
# Install from GitHub
copilot plugin install huqianghui/csa-ppt-plugin
# Or clone to project — Copilot reads .github/plugin/plugin.json
git clone https://github.com/huqianghui/csa-ppt-plugin.git
OpenAI Codex CLI
huqianghui