Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

Chuẩn viết tài liệu Markdown + Mermaid

Kỹ năng buộc mọi báo cáo và tài liệu được viết bằng Markdown kèm biểu đồ Mermaid làm nguồn chính thức.

Tài liệu · Văn phòngNhập môn★ 33,030⑂ 3,248Điểm AI 10/10Cập nhật lần cuối: 9 thg 8, 2026

Kỹ năng này làm gì

  • Thiết lập chuẩn: mọi báo cáo, phân tích, README, bản ghi quyết định đều viết bằng Markdown + Mermaid.
  • Tham chiếu hướng dẫn cho 24 loại biểu đồ Mermaid (flowchart, sequence, ER, gantt, timeline, radar, sankey...) kèm mẫu copy-paste.
  • Khởi đầu từ 9 mẫu tài liệu: bài nghiên cứu, ADR, issue, pull request, báo cáo tiến độ, hướng dẫn how-to...
  • Áp dụng quy tắc chi tiết: một H1 duy nhất, emoji chỉ ở H2, trích dẫn footnote [^N], ưu tiên bảng, bắt buộc accTitle/accDescr, cấm %%{init} và style inline.
  • Ảnh do Python hay AI tạo chỉ là bước 2–3 tùy chọn; bản Mermaid dạng văn bản luôn là nguồn gốc.

Phù hợp với ai

  • Lập trình viên, nhà nghiên cứu quản lý tài liệu bằng Git và muốn diff dễ đọc.
  • Người thường xuyên vẽ quy trình thực nghiệm, luồng dữ liệu, kiến trúc hệ thống.
  • Technical writer, PM muốn đồng bộ style tài liệu cho cả nhóm.

Ví dụ sử dụng

  1. "Thêm biểu đồ cho pipeline thí nghiệm này" → chọn đúng loại biểu đồ (không mặc định flowchart) và chèn block Mermaid có accTitle/accDescr.
  2. "Ghi lại quyết định kiến trúc" → bắt đầu từ templates/decision_record.md để tạo ADR đầy đủ.
  3. "Điền các hình placeholder trong bản thảo" → hình quy trình/quan hệ dùng Mermaid, chỉ hình cần độ chân thực mới chuyển sang skill tạo ảnh.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/markdown-mermaid-writing/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skills/markdown-mermaid-writing từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/markdown-mermaid-writing/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/markdown-mermaid-writing ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

  1. Mở terminal.
  2. Tải repo: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Copy nguyên thư mục skill (cần cả references/ và templates/): cp -r scientific-agent-skills/skills/markdown-mermaid-writing ~/.claude/skills/
  5. Kiểm tra ~/.claude/skills/markdown-mermaid-writing/ có SKILL.md, references/, templates/, assets/.
  6. Khởi động lại Claude Code và thử yêu cầu: "Viết tài liệu này kèm biểu đồ Mermaid".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT