Bạn đã bao giờ muốn tạo tài liệu LaTeX từ ý tưởng chỉ với vài dòng mô tả bằng tiếng Anh? latex document skill claude code là một bộ kỹ năng cho Claude Code giúp bạn làm điều đó: từ ghi chú viết tay, sách giáo khoa scan, dữ liệu thô đến PDF hoàn chỉnh mà không cần biết lệnh LaTeX nào. Repo này cung cấp 27 template, 27 script tự động hóa và 26 hướng dẫn tham khảo, tất cả đều miễn phí và mã nguồn mở.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- 27 mẫu tài liệu LaTeX đã được kiểm tra biên dịch lỗi bằng 0, bao gồm resume, thesis, poster, cheat sheet, exam và nhiều loại khác.
- 27 script tự động hóa giúp biên dịch thông minh (tự chọn engine), OCR ảnh thành LaTeX, mail merge hàng loạt, so sánh phiên bản Git, tạo biểu đồ và bảng từ CSV.
- Hệ thống OCR có 4 hồ sơ chuyển đổi (toán, kinh doanh, pháp lý, ghi chú tổng hợp) – xử lý tài liệu tới 115 trang với 0 lỗi mỗi lô 7 trang.
- Bộ biên dịch thông minh với 525 dòng mã tự động phát hiện engine (pdftex/xetex/luatex), xử lý bibtex/biber, makeindex và tự sửa lỗi phổ biến như thiếu placement cho figure.
- Tích hợp đầy đủ với Claude Code: cài đặt một lệnh và gọi bằng câu lệnh tiếng Anh đơn giản.
Latex Document Skill là gì và giải quyết vấn đề gì?
Latex Document Skill là một bộ kỹ năng (skill) dành cho Claude Code, được thiết kế để loại bỏ rào cản học LaTeX. Thay vì phải nhớ cú pháp \begin{equation} hay \usepackage, bạn chỉ cần mô tả tài liệu bằng tiếng Anh: ‘Create my resume’, ‘Convert my 80-page handwritten math notes into beautiful LaTeX’ hay ‘Generate 9 charts from my sales CSV’. Skill này đọc ý định, chọn template phù hợp, chạy các script tương ứng và trả về file PDF đã biên dịch sẵn kèm ảnh preview.
Vấn đề mà repo giải quyết là sự phức tạp của LaTeX đối với người mới hoặc người không chuyên lập trình. Với sinh viên, nhà nghiên cứu, và cả nhân viên văn phòng, việc tạo resume ATS, luận văn, báo cáo, hay thậm chí cheat sheet từ sách giáo khoa scan trở nên dễ dàng như gõ một câu hỏi cho AI. Bạn có thể xem chi tiết tại repository gốc trên GitHub.
Tính năng nào làm nên sức mạnh của Latex Document Skill?
Biên dịch thông minh với compile_latex.sh
Script compile_latex.sh (525 dòng) không chỉ chạy pdflatex. Nó đọc file .tex và tự động chọn engine: nếu thấy \usepackage{fontspec} thì dùng xelatex, nếu có \directlua thì dùng lualatex, còn lại pdflatex. Nó tự động chạy bibtex/biber, makeindex, makeglossaries và thực hiện đa pass (lên đến 3 lần) để giải quyết tham chiếu chéo. Cơ chế auto-fix sửa các lỗi phổ biến như figure thiếu [htbp] hay thêm microtype khi bị overfull hbox. Khi lỗi xảy ra, script dịch lỗi LaTeX thành thông báo tiếng Anh dễ hiểu, ví dụ thay vì ‘Missing $ inserted’ nó bảo ‘Math symbol used outside $…$ — wrap it in dollar signs’.
OCR Pipeline: Từ ảnh scan thành LaTeX hoàn chỉnh
Pipeline OCR biến bất kỳ PDF scan, ghi chú viết tay hay sách giáo khoa thành file .tex có thể biên dịch. Quy trình: pdf_to_images.sh render trang ở 200 DPI, gửi đến vision model, nhận về LaTeX với định dạng phù hợp hồ sơ đã chọn. Với tài liệu lớn, script chia thành từng lô 7 trang và xử lý song song – kiểm nghiệm trên 115 trang ghi chú toán tay cho thấy 0 lỗi mỗi lô. Bốn hồ sơ gồm: math-notes (tô màu theorem box), business-document (bảng, bullet list), legal-document (đoạn đánh số, trích dẫn luật), general-notes (hỗn hợp).
Mail Merge và tự động hóa hàng loạt
Script mail_merge.py (574 dòng) cho phép tạo N tài liệu cá nhân hóa từ một template và file CSV/JSON. Hỗ trợ hai chế độ: đơn giản với {{first_name}} tự động escape ký tự LaTeX, hoặc Jinja2 cho logic điều kiện và vòng lặp. Sử dụng ProcessPoolExecutor để biên dịch song song, mỗi tài liệu độc lập (cách ly lỗi), cuối cùng gộp bằng qpdf. Ví dụ: gửi thư mời cho 500 ứng viên chỉ với một lệnh.
Charts, Tables, Diagrams từ dữ liệu thô
generate_chart.py tạo 9 loại biểu đồ (bar, line, scatter, pie, heatmap, box, histogram, area, radar) từ JSON hoặc CSV, xuất ra PNG/PDF. csv_to_latex.py chuyển CSV sang bảng LaTeX booktabs/grid/simple, tự động canh cột số. Bốn pipeline diagram: TikZ (inline), Mermaid (qua Puppeteer), Graphviz (6 layout engine), PlantUML – tất cả đều có script riêng.
So sánh phiên bản và tiện ích PDF
latex_diff.sh (409 dòng) tích hợp latexdiff và Git, cho phép so sánh hai file .tex hoặc so với commit/tag cũ, xuất PDF với đánh dấu thay đổi màu sắc (8 kiểu markup). Các script PDF utility: mã hóa AES-256, ghép, nén, trích xuất trang – tất cả dùng qpdf tự động cài nếu thiếu.
Hướng dẫn cài đặt và sử dụng cơ bản
Cài đặt rất đơn giản, chỉ cần sao chép thư mục skill vào đúng vị trí của Claude Code, sau đó chạy script setup. Dưới đây là các bước cụ thể:
- Clone repository hoặc tải xuống toàn bộ thư mục
latex-document. - Chạy lệnh cài đặt:
bash setup.sh– script này tự động cài TeX Live, Poppler, ImageMagick, Pandoc, Python dependencies và các công cụ tùy chọn (Node.js, Java, Graphviz, chktex, latexdiff). - Để verify cài đặt:
bash setup.sh --check - Sao chép thư mục skill vào Claude Code:
cp -r latex-document ~/.claude/skills/ - Sau đó, trong Claude Code bạn có thể gõ các lệnh như ‘Create my resume’ hoặc ‘Convert my handwritten notes to LaTeX’. Skill sẽ tự động chọn template và chạy script tương ứng.
Ví dụ sử dụng trực tiếp script: bash scripts/compile_latex.sh document.tex --preview --auto-fix sẽ biên dịch file .tex thành PDF và tạo ảnh preview PNG. Hoặc dùng mail merge: python3 scripts/mail_merge.py template.tex contacts.csv --output-dir ./letters --workers 4 --merge --merge-name all_letters.pdf.
Ai nên dùng và ai không nên dùng?
Nên dùng nếu: Bạn là sinh viên, nhà nghiên cứu, giảng viên, nhà khoa học dữ liệu, hoặc bất kỳ ai thường xuyên phải tạo tài liệu LaTeX nhưng không muốn mất thời gian học cú pháp. Đặc biệt hữu ích khi bạn có sẵn tài liệu scan (sách, ghi chú tay) và muốn chuyển chúng thành LaTeX có cấu trúc. HR, nhà tuyển dụng, marketer cũng có thể dùng mail merge để gửi thư hàng loạt. Dân SEO có thể tận dụng để tự động hóa tạo báo cáo PDF từ dữ liệu CSV kèm biểu đồ.
Không nên dùng nếu: Bạn đã thành thạo LaTeX và thích kiểm soát từng dòng lệnh – skill này ẩn quá nhiều chi tiết kỹ thuật. Nếu tài liệu của bạn cần tùy chỉnh layout rất đặc thù ngoài 27 template có sẵn, bạn sẽ phải chỉnh sửa template thủ công. Ngoài ra, nếu bạn không dùng Claude Code, bạn vẫn có thể chạy các script độc lập, nhưng sẽ mất đi khả năng giao tiếp bằng tiếng Anh tự nhiên.
Câu hỏi thường gặp
Tôi có cần biết LaTeX để dùng skill này không?
Hoàn toàn không. Bạn chỉ cần mô tả tài liệu bằng tiếng Anh cho Claude Code, skill sẽ tự động chọn template, biên dịch và trả về PDF. Tuy nhiên, nếu muốn tùy chỉnh template, bạn sẽ cần kiến thức LaTeX cơ bản.
Skill này có hỗ trợ tiếng Việt không?
Có, thông qua gói babel/polyglossia. Skill tự động chọn engine XeLaTeX nếu phát hiện gói CJK hoặc RTL. Tuy nhiên, các lệnh mô tả phải bằng tiếng Anh vì đó là ngôn ngữ làm việc của Claude Code.
Tôi có thể dùng các script riêng lẻ ngoài Claude Code không?
Có. Tất cả script đều là shell script hoặc Python, có thể chạy độc lập trong terminal. Bạn chỉ cần đảm bảo đã cài đủ dependencies (qua setup.sh). Hướng dẫn chi tiết từng script có trong thư mục references/.
Làm thế nào để thêm template của riêng tôi?
Bạn có thể copy một template hiện có trong thư mục assets/templates/, chỉnh sửa nội dung, và đặt tên mới. Skill hiện không tự động phát hiện template mới, nhưng bạn có thể gọi trực tiếp script compile_latex.sh với file .tex của bạn.
Skill này có hoàn toàn miễn phí không?
Repo là mã nguồn mở theo giấy phép MIT, hoàn toàn miễn phí. Bạn chỉ cần trả phí nếu dùng Claude Code API của Anthropic hoặc nền tảng HappyCapy (nếu chọn). Bản thân skill không yêu cầu đăng ký hay thanh toán.
Kết luận
Latex Document Skill là một công cụ đáng kinh ngạc cho bất kỳ ai muốn tạo tài liệu LaTeX chất lượng cao mà không cần học cú pháp. Với 27 template đa dạng, 27 script tự động hóa mạnh mẽ và khả năng OCR chính xác, repo này thực sự là trợ thủ đắc lực cho sinh viên, nhà nghiên cứu và nhân viên văn phòng. Hãy truy cập repository gốc trên GitHub để tải về và trải nghiệm. Nếu bạn thấy hữu ích, đừng quên để lại star cho dự án nhé!
