1. Khớp Ngữ Nghĩa Tuyệt Đối 1-1 (Semantic Beat Lock):

   • Lời giảng đọc về vấn đề nào thì trên màn hình xuất hiện thẻ nội dung và bật sáng viền (Active Highlight) tương ứng.
   • Không bị trễ pha, không lặp lại câu lời giảng và triệt tiêu hoàn toàn hiện tượng “đóng băng” màn hình.

2. Thuật Toán Điều Tiết Nhận Thức (Cognitive Audio-Visual Pacing Algorithm):

   • Pha mồi thị giác (Visual Lead-in = 0.35s): Thẻ xuất hiện trước cùng âm thanh SFX nảy nhẹ để mắt người học định vị đối tượng trước khi lời giảng bắt đầu, xóa bỏ hiện tượng phân tán chú ý (Split-Attention).
   • Ngân sách đọc nhận thức (Cognitive Dwell Budget): Tự động tính toán số từ để chèn khoảng nghỉ tĩnh sau câu nói, giúp người học kịp đọc hết nội dung mà không bị câu tiếp theo dồn dập đè lên.

3. Bố Cục Đa Dạng & Trực Quan Hóa Cụ Thể (Zero Monotony):

   • Không rập khuôn một kiểu thẻ cho toàn bộ bài giảng: Áp dụng linh hoạt các layout chuyên biệt như Bậc thang dọc (Vertical Stepper), Băng chuyền luồng dữ liệu (Conveyor Bus), Kim tự tháp phân cấp bộ nhớ, Cắt lớp vi kiến trúc chip, Bảng tính toán chia số học trực quan từng bước…
   • Loại bỏ hoàn toàn hình vẽ tay hay avatar hoạt hình; thiết kế theo phong cách đồ họa công nghệ hiện đại.

4. Đồng Bộ Thẩm Mỹ Tuyệt Đối (Full-bleed Canvas Capture):

   • Chèn trực tiếp khung hình đồ họa độ phân giải cao của từng slide vào PowerPoint (.pptx / .ppt), triệt tiêu 100% lỗi xô lệch layout hoặc lỗi font giữa các hệ điều hành.
   • Nhúng toàn bộ kịch bản lời giảng gốc vào phần Ghi chú Diễn giả (Speaker Notes) để giảng viên sử dụng khi thuyết trình trực tiếp.

e-leaning-maker-agent-skill/
├── .agents/
│   ├── rules/
│   │   └── elearning-standards.md          # Bộ quy chuẩn sư phạm, cỡ chữ & thuật toán cốt lõi
│   └── skills/
│       ├── elearning-pipeline-orchestrator/# Điều phối toàn bộ quy trình tự động từ inputs -> outputs
│       ├── elearning-script-planner/       # Chuẩn hóa kịch bản sư phạm, chia nhịp 1-1 & lập storyboard
│       ├── elearning-tts-srt/              # Tổng hợp giọng đọc VieNeu-TTS & xuất phụ đề SRT
│       ├── elearning-ppt-builder/          # Thiết kế bài trình chiếu PowerPoint Full-bleed 16:9
│       ├── elearning-video-renderer/       # Kết xuất video Motion Graphics MP4 (HyperFrames + FFmpeg)
│       └── elearning-media-fetcher/        # Chuẩn hóa tài nguyên ảnh, icon vector & âm thanh SFX
├── core/                                   # Mã nguồn các engine Python dùng chung cố định
│   ├── motion_graphics_engine.py           # Engine kết xuất đồ họa chuyển động & đồng bộ âm thanh
│   ├── tts_srt_engine.py                   # Engine chuyển văn bản thành giọng nói VieNeu-TTS
│   ├── cognitive_pacing.py                 # Thuật toán điều phối thời gian nghe - nhìn & dwell buffer
│   ├── ppt_builder.py                      # Engine tạo slide PowerPoint 16:9 từ Canvas Stills
│   ├── config.py                           # Cấu hình màu sắc, theme, cỡ chữ, preset giọng đọc
│   └── requirements.txt                    # Danh sách thư viện Python cần thiết
├── inputs/                                 # [Không commit] Nơi đặt kịch bản bài giảng (.md)
├── outputs/                                # [Không commit] Nơi lưu kết quả Video, Slide, MP3, SRT
├── .gitignore                              # Cấu hình loại bỏ dữ liệu sinh ra và file tạm
└── README.md                               # Hướng dẫn sử dụng dự án

• Python: Phiên bản 3.10 trở lên.
• FFmpeg: Đã cài đặt và thêm vào biến môi trường PATH của hệ thống.

Mở terminal tại thư mục gốc của dự án và chạy:

# Tạo môi trường ảo
python -m venv .venv

# Cài đặt toàn bộ thư viện cần thiết
.\.venv\Scripts\pip.exe install -r core/requirements.txt

Dự án được thiết kế chuẩn theo quy cách Agent Skills tương thích với Antigravity IDE, Claude Desktop, Cursor…

1. Tạo thư mục bài học trong inputs/<tên-khóa-học>/ và đặt kịch bản văn bản tại đây (ví dụ: inputs/Nen_tang_CNTT/Video 1.md).
2. Nhập lệnh yêu cầu cho AI Assistant:
   

   “Hãy sản xuất trọn bộ bài giảng E-Learning (Slide PPTX, Lời giảng MP3, Phụ đề SRT và Video MP4) từ kịch bản trong inputs/Nen_tang_CNTT/Video 1.md”

3. Agent sẽ tự động kích hoạt các skill theo quy trình:
   • elearning-script-planner: Lập kế hoạch phân đoạn câu 1-1 và xuất storyboard.
   • elearning-tts-srt: Sinh file 01. lời giảng.mp3 và 01. phụ đề.srt bằng VieNeu-TTS.
   • elearning-ppt-builder: Kết xuất 01. slide hoàn chỉnh.pptx và .ppt.
   • elearning-video-renderer: Dựng hoàn tất 01. video hoàn chỉnh.mp4.

Nếu muốn thực thi độc lập bằng các dòng lệnh:

# 1. Tạo MP3 lời giảng và SRT phụ đề từ Storyboard
.\.venv\Scripts\python.exe core/tts_srt_engine.py --storyboard "outputs/Nen_tang_CNTT/Video-1/storyboard.json"

# 2. Tạo bài trình chiếu PowerPoint Full-bleed
.\.venv\Scripts\python.exe core/ppt_builder.py --storyboard "outputs/Nen_tang_CNTT/Video-1/storyboard.json"

# 3. Kết xuất Video E-Learning MP4 hoàn chỉnh
.\.venv\Scripts\python.exe core/motion_graphics_engine.py --storyboard "outputs/Nen_tang_CNTT/Video-1/storyboard.json" --fps 15

Mỗi bài giảng sau khi xử lý sẽ có cấu trúc thư mục hoàn chỉnh:

outputs/<tên-nội-dung>/
├── plans/
│   ├── Video-1_plan.json                   # Kế hoạch sản xuất có cấu trúc
│   └── Video-1_plan.md                     # Kịch bản sư phạm đạo diễn chi tiết
└── Video-1/
    ├── 01. lời giảng.mp3                   # Âm thanh VieNeu-TTS giọng chuẩn
    ├── 01. phụ đề.srt                      # Phụ đề SubRip chuẩn khớp mili-giây
    ├── 01. slide hoàn chỉnh.pptx            # PowerPoint trình chiếu 16:9 + Notes
    ├── 01. slide hoàn chỉnh.ppt             # Bản PowerPoint tương thích
    ├── 01. video hoàn chỉnh.mp4             # Video bài giảng Full HD hoàn tất
    └── images/                             # Toàn bộ ảnh Canvas độ phân giải cao

Github link: https://github.com/luongit/e-leaning-maker-agent-skill