pptx-giao-trinh

Antigravity Agent Skill — Tạo file PowerPoint (.pptx) chuyên nghiệp từ giáo trình Markdown cho khóa học AI Agent.

Skill này cho phép AI Agent (Antigravity) tự động chuyển đổi bất kỳ file giáo trình .md nào thành file .pptx chất lượng cao, áp dụng hệ thiết kế "Sage & Stone" nhất quán:

• Font: Georgia (tiêu đề) + Verdana (nội dung)
• Palette: kem buttercream + xanh rêu + cam san hô
• Hỗ trợ đầy đủ tiếng Việt có dấu
• 7 kiểu layout đa dạng: Cover, Card Grid, Table, Flowchart, Two-Column, Dual Box, Dark List
• Pipeline QA thị giác tự động

pptx-giao-trinh/
├── SKILL.md                        ← Hướng dẫn Agent (entry point)
├── README.md                       ← File này
│
├── scripts/
│   ├── build_deck_template.py      ← Template trống cho tuần mới
│   ├── build_deck_tuan_02.py       ← Script hoàn chỉnh Tuần 2 (mẫu tham chiếu)
│   └── build_deck_tuan_03.py       ← Script hoàn chỉnh Tuần 3 (mẫu tham chiếu)
│
├── resources/
│   ├── requirements.txt            ← Thư viện Python cần cài
│   ├── config.yaml.template        ← Template cấu hình cho mỗi tuần
│   └── palette_sage_stone.md       ← Bảng màu & typography chi tiết
│
└── references/
    ├── layout-guide.md             ← Hướng dẫn chọn layout cho từng loại nội dung
    └── qa-checklist.md             ← Checklist QA thị giác đầy đủ

# 1. Clone về máy
git clone https://github.com/YOUR_USERNAME/pptx-giao-trinh.git
cd pptx-giao-trinh

# 2. Cài thư viện
pip install -r resources/requirements.txt

# 3. Chạy thử với slide Tuần 2 mẫu
python scripts/build_deck_tuan_02.py

# Bước 1: Copy template
cp scripts/build_deck_template.py scripts/build_deck_tuan_04.py

# Bước 2: Mở file và thay thế các placeholder {{...}}
# - {{TUAN_SO}}     → "04"
# - {{TIEU_DE}}     → "TÊN TUẦN HỌC"
# - {{MO_TA}}       → "Mô tả ngắn"
# - {{NGAY}}        → "22 - 28"
# - {{OUTPUT_PATH}} → "D:/path/to/output/giao_trinh_tuan_04.pptx"

# Bước 3: Viết nội dung từng slide
# Tham khảo build_deck_tuan_02.py và references/layout-guide.md

# Bước 4: Chạy
python scripts/build_deck_tuan_04.py

# Bước 5: Mở PPTX trong PowerPoint và kiểm tra theo references/qa-checklist.md

Font: Georgia (tiêu đề) · Verdana (body) · Courier New (code/path)

Đặt thư mục skill này vào:

• Global: ~/.gemini/config/skills/pptx-giao-trinh/
• Project: .agents/skills/pptx-giao-trinh/

Agent sẽ tự động nhận diện và kích hoạt khi bạn nói:

"Tạo slide cho tuần 4 từ file tuan-04.md" "Build PPTX giáo trình tuần này" "Xuất bộ deck từ file markdown"

• File .py phải có # -*- coding: utf-8 -*- ở đầu để tiếng Việt hiển thị đúng dấu.
• Đóng file PPTX trong PowerPoint trước khi chạy lại script (tránh PermissionError).
• Lỗi UnicodeEncodeError ở dòng print() trên PowerShell Windows không ảnh hưởng đến nội dung file PPTX — đây chỉ là hạn chế của terminal Windows (cp1252).

MIT — Tự do sử dụng, chỉnh sửa và phân phối.