# Documentation Skill

> Quy tắc bắt buộc khi viết và cập nhật tài liệu dự án. Use when this capability is needed.

- Skill: `tomevault-io/documentation-skill-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/documentation-skill-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/documentation-skill-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/documentation-skill-3

---


# Documentation Skill

Áp dụng khi task tạo mới hoặc cập nhật README, docs, release note, hướng dẫn vận hành, kiến trúc, API, changelog hoặc tài liệu theo plan.

## Lưu Trữ

- Tài liệu task lưu trong `docs/` ở root repo.
- Chọn thư mục theo mục đích: `docs/task/`, `docs/plan/`, `docs/summary/`, `docs/bug/`, `docs/knowledge/` hoặc convention sẵn có của repo.
- Mỗi plan quan trọng cần có một doc riêng để ghi mục tiêu, phạm vi, thay đổi, thời gian, kết quả và cách verify.

## Nội Dung

- Viết tiếng Việt có dấu, rõ ý, tránh câu dài và tránh lặp.
- Ghi ngày/thời gian khi tài liệu mô tả một task hoặc quyết định.
- Tài liệu phải khớp source hiện tại; không mô tả file, workflow, feature hoặc test không tồn tại.
- Nếu chỉ là task nhỏ, doc nên ngắn và tập trung vào kết quả review cần biết.
- Không đưa secret, token, credential, payload nhạy cảm hoặc dữ liệu cá nhân vào docs.

## Sau Khi Sửa

- Rà lại docs liên quan để xóa thông tin lỗi thời hoặc ghi chú rủi ro còn lại.
- Nếu thay đổi ảnh hưởng README/changelog/release note, cập nhật các file đó cùng task.
- Nếu không thể verify nội dung, ghi rõ giả định hoặc blocker.

---
> Source: [baolnq-ai/sts-translate-realtime-web](https://github.com/baolnq-ai/sts-translate-realtime-web) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->

