Tóm tắt nhanh:
ak-show-offbiến mô tả hoặc file markdown của bạn thành một trang HTML tự chứa, chia nhiều phần cuộn mượt, có hero ở đầu. Mặc định nó còn chụp ảnh từng phần theo 3 tỉ lệ để đăng mạng xã hội, đăng trang lên và viết song ngữ Việt, Anh. Ba việc đó tắt được, và nó nhớ lựa chọn của bạn cho lần sau.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn vừa xong một tính năng, một dự án hay một bài viết và muốn có trang giới thiệu cùng ảnh để đăng bài. Nó không deploy lên server của bạn: nó chỉ đăng qua CLI agentwiki.
flowchart LR
A["Việc đã làm hoặc file markdown"] --> B["ak-show-off"]
B --> C["content.md + trang HTML"]
C --> D["Ảnh 16:9, 9:16, 1:1"]
C --> E["Đăng lên, nếu bật"]
C --> F["Mở trang trên trình duyệt"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Nhiệm vụ | Trang này khoe cái gì, cho ai xem? | Một đoạn mô tả "giới thiệu chế độ tối mới của app" hoặc đường dẫn tới notes/launch.md |
| Thiết lập nhớ lâu | Có chụp ảnh không, có đăng không, viết mấy thứ tiếng? | Mặc định là chụp ảnh, có đăng, song ngữ vi và en |
| Một lần hay luôn luôn | Bạn đổi thiết lập cho riêng lần này, hay cho mọi lần sau? | "Không chụp ảnh, chỉ lần này thôi" thì lần sau vẫn chụp; bỏ "chỉ lần này" thì nó lưu luôn |
| Cổng bàn giao | Trang đã đủ tốt để đưa cho bạn chưa? | Soát 5 tiêu chí: hợp ngữ cảnh, thứ bậc thị giác, độ chăm chút, dễ dùng, không vỡ bố cục |
Thiết lập được lưu theo người dùng, không theo dự án, nên một lần tắt đăng sẽ áp cho mọi dự án sau.
Prompt mẫu cho khoe một tính năng vừa xong:
/ak-show-off Giới thiệu chế độ tối mới của app <tên app>:
tự đổi theo hệ điều hành, giữ độ tương phản khi đọc lâu, bật tắt một chạm.
Người xem: người dùng hiện tại và người theo dõi trang của dự án.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt hình minh hoạ ở các phần không phải hero | 2.13.0 |
--no-screenshots | Không chụp ảnh từng phần | 1.0.0 |
--no-publish | Giữ mọi thứ trên máy, không đăng | 1.0.0 |
--languages | Chọn ngôn ngữ của trang | 1.0.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-show-off: trang HTML trình diễn việc bạn vừa làm" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-show-off". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-show-off
