AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop

Skill

Sản xuất các biến thể banner campaign với ak:banner-design

Thiết kế và export asset social, ad, web hoặc print-banner có thể review trong khi phê duyệt riêng provider call, browser export, placement, chi phí và publication.

Dùng ak:banner-design để biến campaign brief thành nhiều phương án art direction, composition HTML/CSS và asset banner PNG đã export. Skill bao quát social cover, display ad, website hero, campaign creative và concept print-banner. Skill không edit video, thiết kế website hoàn chỉnh, thực hiện print production, mua media hay publish kết quả.

Chọn ak:banner-design cho một visual có scope rõ ràng

Dùng ak:banner-design khi

  • Bạn cần banner, cover, header, display-ad creative, website-hero visual hoặc concept print-banner.
  • Bạn biết purpose, platform hoặc dimension, content, constraint thương hiệu và số lượng phương án mong muốn.
  • Bạn muốn background hoặc illustration được tạo kết hợp với typography HTML/CSS, logo placement và CTA treatment có kiểm soát.
  • Bạn có thể review claim, quyền, safe zone, contrast, responsive crop và dimension export cuối trước khi dùng.

Chọn workflow khác khi

  • Bạn cần thumbnail YouTube. Dùng ak:youtube-thumbnail-design.
  • Bạn cần logo hoặc khám phá identity rộng hơn. Dùng ak:logo-design.
  • Bạn cần implementation page hoặc site hoàn chỉnh. Dùng workflow frontend design và development phù hợp.
  • Bạn cần printer-ready preflight, mua media, thay đổi ad account hoặc publish campaign. Đây là các workflow production và tài khoản riêng.

Chuẩn bị content, tool và dimension

Trước khi bắt đầu:

  • Hoàn thành Làm quen và xác nhận Marketing Kit đã được cài cho runtime cùng scope hiện tại.
  • Cung cấp purpose, platform, dimension chính xác, headline, supporting text, CTA, logo placement, brand rule, style preference và quantity. Brief trong package mặc định có ba phương án.
  • Xác nhận mọi logo, font, photo, illustration, product image, claim và likeness có thể được dùng trong channel cùng territory dự kiến.
  • Cung cấp brand guidance đã duyệt. Nếu chưa có, hãy nêu constraint tạm thời thay vì bịa identity rule lâu dài.
  • Phê duyệt GEMINI_API_KEY, quyền truy cập mạng provider và command đã pin npx -y -p @mrgoonie/multix@0.2.0 multix nếu yêu cầu AI visual.
  • Cung cấp browser cục bộ hoặc browser tool được hỗ trợ cùng quyền serve HTML cục bộ khi yêu cầu PNG export đúng dimension.
  • Chọn output directory có quyền ghi và xác nhận tệp hiện có có thể bị thay hay không.
RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:banner-design ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ. Browser export và provider generation vẫn phụ thuộc tool khả dụng.
Cursor/ak:banner-design ...Cách gọi bằng slash đã được người dùng xác minh. Behavior capture và preview trong browser có thể khác theo thiết lập.
Codex$ak:banner-design ...Skill dùng discovery native của Codex. Hook projection một phần không cung cấp browser, provider key hay print pipeline.

Xem Runtime adapter trước khi giả định capability export giống nhau giữa các target.

Chạy Skill

Nêu platform, style, dimension, content, brand, quantity và hành động bên ngoài không được thực hiện.

/ak:banner-design LinkedIn personal banner, minimalist editorial, 1584x396. Headline: "Privacy-first analytics". Dùng logo và palette xanh đã duyệt. Tạo ba bản nháp HTML/PNG, giữ content quan trọng trong safe area và không publish hay thay đổi tài khoản

Xác định các field production

FieldNội dung cần cung cấp
Platform và purposeSocial cover, display ad, website hero, campaign creative hoặc print concept
DimensionWidth và height chính xác từ specification hiện tại của placement
ContentHeadline, subtext, CTA, logo, disclosure bắt buộc và claim bị cấm
BrandColor, typography, imagery, spacing và logo rule đã duyệt
StyleMột hoặc nhiều hướng như minimalist, bold typography, gradient, photo-based, geometric, retro, glassmorphism, neon, editorial hoặc 3D
Quantity và formatSố variant, size set, HTML source, PNG export và expectation về filename
Ranh giới quyền hạnImage generation, local serving, browser capture, thay tệp, publication, printing hay ad spend có được phép không

Bảng size trong package là điểm bắt đầu hữu ích, không phải live platform contract. Dùng specification hiện tại của placement khi có khác biệt.

Theo các giai đoạn banner

  1. Xác nhận brief. Skill ghi purpose, size, copy, CTA, brand, style, variant, quyền và authority.
  2. Chọn art direction. Skill có thể dùng reference 22 style trong package cùng research inspiration bên ngoài tùy chọn. Browsing bên ngoài cần phê duyệt riêng về network và review nguồn.
  3. Tạo composition. Workflow xây layout HTML/CSS ở dimension được yêu cầu và có thể tạo visual element qua tuyến Gemini đã duyệt.
  4. Serve và export. Local server cùng browser capture có thể render từng composition HTML thành PNG ở viewport chính xác được yêu cầu.
  5. Review variant. Kiểm tra copy, claim, contrast, cách dùng logo, safe zone, crop behavior, dimension, file size và quyền source.
  6. Dừng trước activation. Publication, thay đổi tài khoản, tạo ad, budget, print order và distribution vẫn cần phê duyệt riêng.

Giữ tác động bên ngoài dưới bước review

Đã export không đồng nghĩa sẵn sàng cho placement

PNG có thể đúng dimension nhưng vẫn không đạt policy platform, crop, disclosure, file-size, accessibility hoặc requirement print. Xác minh placement thực tế trước upload, mua hoặc production.

Nhóm công việcRanh giới thông thường
Hướng dẫn và soạn nhápSkill có thể tạo brief, art direction, copy layout và HTML cục bộ trước provider generation.
Thay đổi cục bộSkill có thể tạo hoặc thay tệp HTML, PNG và khởi động local server tạm thời để export. Xác nhận đích và dừng server sau đó.
Tác động provider và mạngImage generation và research reference tùy chọn có thể gửi prompt hoặc dữ liệu ra ngoài, fetch executable package, tiêu quota và phát sinh chi phí.
Publish, print và chi phíSkill không cấp quyền thay đổi tài khoản, tạo ad, dùng campaign budget, upload, schedule, đặt in hay production vật lý.

Không dùng photo, font, logo, trademark hay dữ liệu cá nhân không có license. Xác minh mọi offer, price, statistic, testimonial, comparison và legal disclosure bằng source material đã duyệt. Visual được tạo không được ngụ ý endorsement hoặc product capability không tồn tại.

Review output và bằng chứng

Quy ước PNG trong package là:

assets/banners/{campaign}/
├── minimalist-1500x500.png
├── gradient-1500x500.png
├── bold-type-1500x500.png
└── minimalist-1080x1080.png

Tệp time-sensitive có thể dùng {YYMMDD}-{style}-{size}.png. Giữ HTML source đã dùng để export khi cần reproducibility. Báo cáo cuối nên xác định:

  • Brief, dimension, style, brand input, copy, CTA và disclosure bắt buộc đã dùng cho từng variant.
  • Request provider generation, reference bên ngoài, local server cùng browser capture đã dùng và export bị lỗi nếu có.
  • Path HTML và PNG chính xác, pixel dimension, file size và compression.
  • Check về visual, copy, contrast, crop, quyền và placement.
  • Candidate đã chọn cùng mọi hành động tài khoản, chi phí, print hoặc publish còn chờ phê duyệt.

Xử lý sự cố an toàn

Triệu chứngBước tiếp theo an toàn
Runtime không tìm thấy ak:banner-designXác nhận target cùng scope, mở session mới, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.
Dimension bị thiếu hoặc mâu thuẫnDừng và lấy width, height, safe zone cùng file limit hiện tại của placement trước khi compose.
Provider generation không khả dụngTiếp tục bằng asset cục bộ được duyệt hoặc bản nháp chỉ có layout; không tuyên bố đã tạo ảnh.
Browser export khác HTMLKiểm tra lại viewport, font đã load, local asset path và capture timing, sau đó ghi chính xác cách export.
Text hoặc logo bị cropTừ chối export, đưa content quan trọng vào safe area đã xác minh và capture lại.
PNG vượt giới hạn placementGiữ source và compress một bản sao; xác minh dimension cùng visual quality sau compression.
Yêu cầu print outputChuyển concept đã duyệt sang workflow print production để kiểm tra CMYK, bleed, DPI, proofing và vendor.

Tiếp tục với Tổng quan Marketing Kit hoặc Projects, artifacts và checkpoints.

Biết các giới hạn hiện tại

  • Argument hint của Skill là [platform] [style] [dimensions]; copy, brand, quantity và authority còn thiếu vẫn cần được resolve trong brief.
  • Command image generation hỗ trợ tập aspect ratio có giới hạn. Banner rất rộng có thể cần crop, compose trong HTML/CSS hoặc source asset được duyệt khác thay vì native generation khớp chính xác.
  • Browser capture phụ thuộc tool khả dụng, font loading và quyền truy cập local asset. Thiết kế ở mức source không đảm bảo render giống hệt trên mọi runtime.
  • Platform size và design guidance trong package có thể cũ; specification hiện tại của placement và printer được ưu tiên.
  • Banner variant không đảm bảo click-through rate, conversion, revenue, approval, delivery, accessibility hay print fidelity.