Tóm tắt nhanh:
ak-mintlifysửa và kiểm site tài liệu Mintlify: thêm trang, đổi giao diện, dựng mục API, làm docs dễ dùng cho AI hay đưa docs lên mạng. Nó đọc site đang có trước rồi chạy lệnh kiểm mà project đã cài. Nó không cài CLI toàn máy, không tạo site mới chỉ để sửa một trang, và không báo deploy xong khi chưa có bằng chứng.
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 có một site tài liệu chạy bằng Mintlify và cần thêm trang, đổi giao diện, dựng mục API hay đưa docs lên mạng. Không cần nếu bạn chưa có site Mintlify và cũng không định tạo site mới.
flowchart LR
A["Việc trên site Mintlify"] --> B["ak-mintlify"]
B --> C["Sửa docs.json, MDX, navigation, API"]
C --> D["Lệnh kiểm đã cài chạy sạch"]
B --> E["Deploy tới đích bạn nêu"]
E --> F["Bằng chứng site đã lên"]Nó bám 4 nguyên tắc:
| Nguyên tắc | Câu hỏi | Ví dụ |
|---|---|---|
| Đọc site trước khi làm | Site của bạn đang dựng thế nào? | Mở thư mục docs, package.json, lockfile, docs.json, navigation trước khi chọn lệnh |
| Sáu mảng việc | Việc của bạn thuộc mảng nào? | Cấu hình, nội dung, navigation, OpenAPI, deploy, AI (llms.txt, menu mở bằng AI, MCP) |
| Đúng phiên bản đang cài | Ví dụ cấu hình này còn đúng với bản Mintlify của tôi không? | Xem help của CLI trong project và docs đúng phiên bản, không áp thẳng ví dụ cũ |
| Kiểm sau khi sửa | Bằng chứng nào cho thấy sửa xong mà không hỏng? | mint validate sạch, mint broken-links không còn link hỏng, xem bản render nếu bố cục đổi |
Nếu project đã có preview đang chạy thì nó dùng lại. Tiến trình nào nó tự mở thì nó ghi lại lệnh, PID, cổng, và dừng khi xong việc.
Prompt mẫu cho việc thêm trang mới:
/ak-mintlify Thêm trang "Webhooks" vào docs của <tên sản phẩm> ở <thư mục docs>.
Nội dung: cách đăng ký webhook, ví dụ payload, cách xác minh chữ ký.
Ràng buộc: xếp vào nhóm "Guides" có sẵn trong navigation, không đổi theme.
Xong khi: lệnh validate và broken-links của project chạy sạch.Skill này không có cờ. Sau tên lệnh bạn ghi việc cần làm, có thể kèm một đường dẫn trong project, hoặc chỉ mô tả việc bằng lời.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách ghi đầu và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-mintlify: sửa và kiểm site docs Mintlify" 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-mintlify". 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-mintlify
