Viết conversion copy với ak:copywriting

Dùng ak:copywriting để biến brief cụ thể về audience, offer, channel và brand voice thành persuasive copy. Skill cung cấp formula, pattern cho headline và CTA, cấu trúc theo channel, copy-brief template cùng helper trích xuất tín hiệu writing style từ asset của project.

Chọn ak:copywriting cho persuasive copy

Dùng ak:copywriting khi

• Bạn cần headline, subject line, email sequence, section của landing page, product description, social post, CTA hoặc A/B variant.
• Bạn có audience, offer, proof point, hành động mong muốn và constraint để tạo thành draft có thể review.
• Bạn muốn phân tích writing sample đã duyệt và áp dụng các style dimension có thể quan sát mà không sao chép nội dung của mẫu.

Chọn workflow khác khi

• Bạn cần tài liệu factual cho product hoặc API. Dùng ak:docs và chỉ coi tính thuyết phục là bước biên tập phụ.
• Bạn cần triển khai trọn interface quanh copy. Dùng ak:frontend-design hoặc ak:frontend-development sau khi message đã rõ.
• Bạn cần market evidence, legal review, brand approval hoặc nghiên cứu platform policy hiện hành. Hãy lấy bằng chứng đó riêng; template của Skill không thiết lập chúng.
• Source chứa tài liệu cá nhân, bí mật, được cấp phép hoặc chưa công bố nhưng chưa được phép đưa vào model processing.

Chuẩn bị brief và source material

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

• Hoàn tất Onboarding, rồi xác nhận Engineer Kit được cài cho runtime và scope hiện tại.
• Cung cấp audience, awareness level, pain point, goal, offer, primary CTA, format, độ dài, tone, mục bắt buộc, mục cần tránh và success metric.
• Cung cấp proof chính xác và có thể bảo vệ: product behavior, giá, ngày, guarantee, customer quote, kết quả study và legal qualifier. Đánh dấu nội dung nào là placeholder thay vì claim đã xác minh.
• Xác định brand hoặc writing sample đã duyệt và runtime có được đọc hoặc gửi chúng tới external processor hay không.
• Nêu output location nếu muốn ghi file. Nếu không, hãy yêu cầu copy trong phản hồi và giữ project không đổi.

Argument hint được khai báo là [copy-type] [context], nhưng Skill không định nghĩa parser, danh sách copy type cố định hay output file mặc định. Hãy nêu deliverable và ranh giới mong muốn bằng ngôn ngữ tự nhiên.

Chạy Skill với brief đầy đủ

/ak:copywriting "Draft a landing-page hero and three headline variants for finance leads who already know the problem. Use only the supplied product facts and approved customer quote, keep the tone direct and professional, use one CTA to book a demo, and flag every missing proof point instead of inventing it. Return copy in chat; do not write files."

/ak:copywriting "Draft a landing-page hero and three headline variants for finance leads who already know the problem. Use only the supplied product facts and approved customer quote, keep the tone direct and professional, use one CTA to book a demo, and flag every missing proof point instead of inventing it. Return copy in chat; do not write files."

$ak:copywriting "Draft a landing-page hero and three headline variants for finance leads who already know the problem. Use only the supplied product facts and approved customer quote, keep the tone direct and professional, use one CTA to book a demo, and flag every missing proof point instead of inventing it. Return copy in chat; do not write files."

Brief đi kèm sắp xếp project information, audience và awareness, deliverable detail, key message, proof, constraint, formula cùng success metric. Bạn có thể cung cấp trực tiếp cùng thông tin hoặc yêu cầu Skill hiển thị quyết định còn thiếu trước khi draft.

Chọn pattern nhưng không coi là proof

Reference material chứa conversion tip lịch sử, platform limit và example performance claim. Hãy coi chúng là prompt cần kiểm thử, không phải benchmark hiện hành hay guarantee. Xác minh platform rule và campaign data tại thời điểm sử dụng.

Trích xuất writing style có chủ đích

Helper đi kèm quét assets/writing-styles/ để tìm text, document, image hoặc video đã duyệt. Các mode dành cho người dùng là --list, --style <name>, --all, --json và --verbose.

python scripts/extract-writing-styles.py --list
python scripts/extract-writing-styles.py --style founder-voice --json

File .md và .txt thuần được đọc local. Input PDF, DOCX, XLSX và PPTX gọi Multix document conversion. Input image và video gọi Multix Gemini analysis. Vì vậy helper có thể tải và thực thi @mrgoonie/multix@0.2.0, dùng network, gửi source material tới model provider và cần GEMINI_API_KEY cho các nhánh bên ngoài đó.

Với document conversion, helper ghi một file Markdown tạm ẩn bên cạnh source style asset và xóa nó sau khi đọc được output thành công. Lần chạy lỗi hoặc bị ngắt cần kiểm tra directory rõ ràng. Kết quả --all của release không khớp shape mà text formatter mong đợi, vì vậy đừng dựa vào mode đó khi chưa sửa hoặc xác minh độc lập; hãy xử lý từng named style.

Quan sát các giai đoạn

1. Skill xác nhận copy contract. Skill xác định reader, awareness level, offer, channel, objective, CTA, proof, voice, constraint và output boundary.
2. Skill chọn structure. Formula và channel pattern sắp xếp draft; chúng không cung cấp fact còn thiếu.
3. Skill nghiên cứu style evidence đã duyệt. Skill dùng dimension đã nêu hoặc phân tích sample được cấp quyền, tách trait quan sát được khỏi nội dung của source.
4. Skill draft và tạo variation. Main copy cùng variant được yêu cầu giữ nguyên factual contract trong khi kiểm thử một khác biệt message có giới hạn.
5. Skill kiểm tra kết quả. Claim, specificity, reader fit, CTA consistency, tone, prohibited language và channel constraint được review.
6. Skill trả evidence. Kết quả nêu pattern đã chọn, source fact, assumption, proof gap chưa xử lý, variant cùng file hoặc service đã dùng.

Kiểm soát claim, quyền và tác động bên ngoài

• Xin phép trước khi gửi source document hoặc media tới external provider, nhất là customer data, internal strategy, unpublished work hay licensed creative material.
• Style transfer nên tái tạo trait trừu tượng như pace và tone, không sao chép passage đặc trưng, personal likeness hay tạo deceptive authorship.
• Không tạo testimonial, logo, statistic, deadline, stock level, guarantee, security claim hoặc endorsement giả.
• Skill có thể draft copy hoặc ghi artifact được yêu cầu rõ ràng. Skill không publish page, gửi email, đăng social network, khởi chạy A/B test, mua media hay duyệt legal claim nếu không có workflow được cấp quyền riêng thực hiện.

Xác minh output và evidence

Một kết quả hữu ích nên gồm:

• Final copy theo format và độ dài yêu cầu, cùng variant có label rõ ràng khi được yêu cầu.
• Audience, awareness, offer, CTA, formula hoặc structure và style dimension đã dùng để tạo draft.
• Claim ledger phân biệt supplied fact, cited proof, assumption, placeholder và statement vẫn cần legal, brand hoặc subject-matter approval.
• Chính xác file đã đọc hoặc ghi, temporary file đã kiểm tra, helper command đã chạy, external provider đã dùng cùng failure hoặc stage bị bỏ qua.
• Review ngắn theo must-include, must-avoid, voice, accessibility, channel và success-metric requirement.

Writing-style guide đi kèm trình bày sáu preset definition chi tiết dù reference table của Skill gọi đó là quick reference 30 style. Đừng báo có 30 style sẵn dùng. Hai release stable và beta được ghim chứa cùng Skill file, và không tìm thấy automated test có scope trực tiếp cho copy workflow hay extraction helper.

Khắc phục sự cố và hiểu giới hạn

Dùng ak:docs cho factual documentation hoặc ak:frontend-design khi copy nằm trong interface cần được triển khai.