Perxel Social Kit

Perxel Social Kit là bộ công cụ mã nguồn mở giúp AI agent tạo ảnh và video ngắn cho mạng xã hội. Bạn mô tả bài đăng cho agent đang dùng (Claude Code, Cursor hoặc agent khác), agent dùng kit để render bài đó ra ảnh vuông 1:1, ảnh ngang 16:9 và ảnh dọc 9:16 (hoặc video), rồi tự xem lại tất cả kích thước trước khi gửi kết quả. Template là component React nằm ngay trong repo của dự án, nên hình ảnh mang đúng thương hiệu của bạn.

Bài toán

Mỗi lần đăng bài, cùng một nội dung cần nhiều kích thước: ảnh vuông cho LinkedIn, ảnh ngang cho X và website, ảnh dọc cho Stories, Reels và TikTok. Nếu làm bằng công cụ thiết kế thì mỗi kích thước là một file riêng, và mỗi lần sửa chữ lại phải sửa ở tất cả các file. Ảnh dọc còn có thêm một rủi ro: phần trên và phần dưới màn hình bị các nút của ứng dụng che mất.

Với Social Kit, nội dung nằm ở một chỗ và bố cục cho từng kích thước nằm trong template. Khi cần sửa, bạn chỉ cần nói với agent.

Cài đặt và cách dùng

Chạy npx @perxel/social-kit init trong repo của dự án. Lệnh này cài kit, tạo thư mục social/ với bài đăng đầu tiên và cài skill hướng dẫn agent cách dùng kit. Sau đó, bạn chỉ cần nhờ agent, ví dụ: "Tạo bài đăng thông báo ra mắt sản phẩm mới, đủ các kích thước".

Skill hướng dẫn agent làm theo đúng quy trình: kiểm tra môi trường, dùng màu, font và template có sẵn của dự án, render mọi kích thước, rồi tự xem contact sheet để sửa chữ tràn khung hoặc nội dung nằm trong vùng bị che trước khi gửi bạn. Agent không tự thêm câu chữ bạn chưa duyệt mà chỉ đề xuất. Nếu muốn tự chạy các lệnh của kit, xem hướng dẫn trên GitHub.

Kit làm được gì

• Đủ mọi kích thước trong một lần render. Các file được đặt tên theo bài đăng (ví dụ launch-square.png, launch-portrait.mp4), kèm một contact sheet để xem tất cả cạnh nhau.
• Bố cục riêng cho từng kích thước. Ảnh dọc có thể sắp xếp khác ảnh ngang thay vì chỉ thu nhỏ, và chừa trống vùng bị nút ứng dụng che.
• Video ngắn khớp nhịp nhạc. Kit đọc tempo và nhịp của bài nhạc, nên agent có thể chuyển cảnh đúng phách. Phần video được dựng bằng Remotion.
• Một chiến dịch trong một thư mục. Một template có thể vẽ cả ảnh tĩnh lẫn video, nên một bài đăng cho ra đủ ảnh và video của cùng một chiến dịch.
• Ảnh và video cho bài viết trên website. Agent có thể chụp trang web đang chạy, quay video ngắn các thao tác (cuộn trang, gõ phím, bấm ⌘K) và dựng ảnh minh họa từ template. Các bước được lưu thành một file công thức, nên khi giao diện thay đổi, agent tạo lại toàn bộ hình ảnh theo đúng công thức đó.

Perxel dùng kit như thế nào

Các ảnh và video Perxel đăng trên mạng xã hội, cùng phần lớn hình ảnh trong bài viết trên website này, đều được tạo bằng Social Kit qua AI agent. Template, logo và nhạc nằm trong repo của website, còn kit chỉ lo phần render, nên mọi thay đổi về thương hiệu đều được sửa trong repo website.

Giấy phép

Kit phát hành theo giấy phép MIT trên GitHub và npm. Phần video và template chạy trên trình duyệt dùng Remotion, thư viện này miễn phí cho cá nhân và công ty tối đa 3 người, công ty lớn hơn cần mua giấy phép của Remotion. Ảnh tĩnh thông thường không cần Remotion.

Footnotes

1. perxel-social-kit trên GitHub
2. @perxel/social-kit trên npm
3. Giấy phép Remotion