Trình viết Alt Text tiếp cận được
Tạo và cải thiện alt text dễ tiếp cận cho biểu đồ, hình ảnh trong gói R (pkgdown) và tài liệu Quarto, dựa trên chính mã nguồn vẽ hình.
Nội dung · Viết láchTrung cấp★ 467⑂ 38Điểm AI 7/10Cập nhật lần cuối: 5 thg 8, 2026
Làm được gì
- Tự nhận diện loại dự án bằng cách kiểm tra
_pkgdown.yml, rồi đọc tài liệu tham chiếu tương ứng (pkgdown hoặc Quarto). - Khai thác mã nguồn vẽ biểu đồ (biến trên trục, mã hóa màu, số panel facet, đường xu hướng) và văn bản xung quanh để lấy thông tin chính xác thay vì đoán mò.
- Viết theo công thức ba phần: loại biểu đồ → mô tả dữ liệu → thông điệp chính.
- Đọc caption (
fig-cap,fig.cap) trước để alt text bổ sung chứ không lặp lại. - Kèm mẫu câu cho từng loại biểu đồ, bảng độ dài khuyến nghị và checklist chất lượng.
Phù hợp với ai
- Người bảo trì tài liệu gói R dùng pkgdown và ggplot2.
- Nhà phân tích dữ liệu viết báo cáo, sách, blog bằng Quarto (.qmd).
- Nhóm cần rà soát khả năng tiếp cận (WCAG) cho hình ảnh trong tài liệu kỹ thuật.
Ví dụ sử dụng
- "Thêm fig.alt cho tất cả hình trong vignette của gói này" → đọc code từng chunk và viết hàng loạt.
- "Cải thiện alt text của hình
fig-normalizationtrong chapter-03.qmd" → bỏ phần trùng caption, tập trung vào insight. - "Kiểm tra alt text hiện có có đạt chuẩn không" → dùng checklist để chỉ ra lỗi như thiếu tên biến trục hay mở đầu bằng "Hình ảnh về…".
· · · 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/posit-dev/skills/HEAD/alt-text/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)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
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 alt-text từ repo GitHub posit-dev/skills vào ~/.claude/skills/alt-text/ 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/posit-dev/skills.git /tmp/posit-skills && mkdir -p ~/.claude/skills && cp -r /tmp/posit-skills/alt-text ~/.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.
- Mở Terminal.
- Tải mã nguồn:
git clone https://github.com/posit-dev/skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép nguyên thư mục alt-text (phải có cả thư mục
references/):cp -r skills/alt-text ~/.claude/skills/ - Mở terminal tại thư mục dự án R hoặc Quarto và chạy
claude. - Yêu cầu ví dụ: "Viết alt text cho các hình trong tài liệu này" — skill sẽ tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT