Technical Writing

Skill seo giúp kiểm tra, lập kế hoạch và triển khai SEO kỹ thuật, tối ưu on-page, dữ liệu có cấu trúc, Core Web Vitals và ánh xạ từ khóa. Hãy dùng khi cần crawlability, indexability, metadata, schema, liên kết nội bộ, thay đổi sitemap và robots, hoặc SEO cho Keyword Research, với hướng dẫn cụ thể theo từng trang, có thể triển khai ngay.

Kỹ năng java-coding-standards cung cấp hướng dẫn thực tế để viết Java 17+ dễ đọc, dễ bảo trì trong các dịch vụ Spring Boot, bao gồm đặt tên, bất biến, Optional, streams, exceptions, generics và bố cục package. Hãy dùng nó khi coding, refactoring và review mã với java-coding-standards.

cpp-coding-standards là hướng dẫn tiêu chuẩn lập trình C++ dựa trên C++ Core Guidelines. Dùng nó khi viết, review và refactor C++ hiện đại, với trọng tâm là an toàn, rõ ràng, dễ bảo trì, RAII, an toàn kiểu và thiết kế tốt. Rất phù hợp cho Code Review bằng cpp-coding-standards và các quyết định thực tế trong team.

code-tour tạo các file CodeTour `.tour` có thể tái sử dụng với anchor thật theo file và dòng. Hãy dùng skill code-tour cho các tour onboarding, walkthrough kiến trúc, tour PR, luồng RCA, và code-tour cho Technical Writing khi bạn cần một chuỗi dẫn dắt thay vì bản tóm tắt phẳng.

Skill viết bài viết giúp soạn nội dung dài với cấu trúc chặt chẽ, giọng văn nhất quán và dẫn chứng rõ ràng. Hãy dùng cho bài viết, hướng dẫn, tutorial, newsletter và các workflow Copywriting cần văn phong chỉn chu, sẵn sàng xuất bản.

architecture-decision-records giúp ghi lại các quyết định kiến trúc trong các phiên Claude Code dưới dạng ADR có cấu trúc. Skill này phát hiện những thời điểm cần ra quyết định, ghi lại bối cảnh, các phương án thay thế và lý do lựa chọn, đồng thời duy trì nhật ký ADR để người bảo trì sau này tham khảo. Hữu ích cho Technical Writing và các nhóm kỹ thuật cần lưu giữ lịch sử quyết định bền vững.

api-design là skill hỗ trợ thiết kế REST API, dùng để lập kế hoạch và rà soát endpoint, cách đặt tên resource, mã trạng thái, phân trang, lọc, versioning và phản hồi lỗi.

brainstorming là skill dùng trước khi triển khai, giúp làm rõ bối cảnh, đặt câu hỏi làm rõ từng câu một và yêu cầu phê duyệt thiết kế trước khi viết bất kỳ đoạn code nào. Skill cũng có visual companion tùy chọn và hỗ trợ tốt cho Requirements Planning.

writing-plans giúp biến spec hoặc tài liệu yêu cầu thành kế hoạch triển khai chi tiết, kèm hướng dẫn theo từng file, thứ tự thực hiện công việc, các bước kiểm thử và lời nhắc rà soát trước khi bắt đầu viết mã.

doc-coauthoring là quy trình có cấu trúc để soạn tài liệu cùng AI: thu thập ngữ cảnh, lên dàn ý lặp, viết theo từng phần và thử nghiệm với người đọc nhằm tạo spec, RFC và proposal sẵn sàng để review.

technical-writer là một skill tài liệu gọn nhẹ giúp tạo README, tài liệu API, hướng dẫn thiết lập, tutorial, tài liệu onboarding và release notes rõ ràng hơn. Skill này đặt Technical Writing xoay quanh mục tiêu của người dùng, phần bắt đầu nhanh, ví dụ minh họa và xử lý sự cố. Toàn bộ skill được phân phối dưới dạng một tệp SKILL.md duy nhất, không kèm script hay mẫu bổ sung.

document-release là một skill cập nhật tài liệu sau khi phát hành, có nhiệm vụ đọc tài liệu dự án, đối chiếu với diff đã ship, rồi cập nhật README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, CHANGELOG và VERSION để tài liệu khớp với những gì thực sự đã được phát hành. Hãy dùng skill document-release cho kỹ thuật viết tài liệu khi code đã được merge và bạn cần một hướng dẫn document-release đáng tin cậy.

caveman là một skill giao tiếp siêu cô đọng dành cho các phản hồi kỹ thuật ngắn gọn, tóm tắt và hỗ trợ gỡ lỗi. Skill này giữ nguyên ý nghĩa kỹ thuật, lược bỏ phần thừa và vẫn ở chế độ chủ động sau khi được kích hoạt cho đến khi bạn nói stop caveman hoặc normal mode. Phù hợp nhất cho Technical Writing, ghi chú review code, cập nhật sự cố và trao đổi qua lại nhanh hơn khi bạn đã nắm rõ chủ đề.

Kỹ năng edit-article giúp bạn cấu trúc lại các bản nháp hiện có, cải thiện độ rõ ràng và tinh gọn câu chữ. Hãy dùng nó khi bạn cần một hướng dẫn edit-article đáng tin cậy để chỉnh sửa bài viết, đặc biệt trong các quy trình viết kỹ thuật nơi thứ tự phần và các phụ thuộc nội dung rất quan trọng.

writing-shape là một kỹ năng soạn thảo theo hội thoại, giúp biến tài liệu markdown thô thành một bài viết có thể xuất bản. Kỹ năng này hỗ trợ chọn cách mở bài, phát triển từng đoạn, và quyết định cấu trúc cho Technical Writing, ghi chú phỏng vấn, dọn sạch transcript, và bản nháp sơ bộ. Hãy dùng hướng dẫn writing-shape khi bạn cần một quy trình biên tập có dẫn dắt thay vì chỉ một prompt dùng một lần.

grill-with-docs là một skill về lập kế hoạch và tài liệu hóa, giúp thử áp lực kế hoạch của bạn trước mô hình miền sẵn có của repo, tinh chỉnh thuật ngữ và cập nhật CONTEXT.md cùng ADRs khi các quyết định dần rõ ràng. Hãy dùng nó cho Technical Writing, kỹ thuật thiên về sản phẩm, và mọi quy trình mà ngôn ngữ bám sát repo quan trọng hơn một buổi brainstorm chỉ dựa trên prompt.

ubiquitous-language là một skill theo phong cách DDD dùng để trích xuất bảng thuật ngữ chung từ hội thoại, phát hiện các thuật ngữ mơ hồ và từ đồng nghĩa, rồi ghi ra `UBIQUITOUS_LANGUAGE.md`. Hãy dùng nó để định nghĩa thuật ngữ miền, giúp các nhóm thống nhất cách gọi và cải thiện ubiquitous-language cho Technical Writing.

python-code-style hỗ trợ định dạng mã Python, linting, quy ước đặt tên, type hint và docstring. Dùng skill này để review pull request, chuẩn hóa quy ước trong nhóm, và thiết lập hướng dẫn cho ruff, mypy hoặc pyright trong `pyproject.toml`.

architecture-decision-records giúp các nhóm soạn thảo và duy trì ADR với bối cảnh, quyết định, phương án thay thế và hệ quả được trình bày rõ ràng, để lưu trữ tài liệu quyết định kỹ thuật bền vững theo thời gian.

Skill changelog-automation giúp các nhóm xây dựng quy trình changelog với Keep a Changelog, SemVer, release note và Conventional Commits. Dùng skill này để xác định bối cảnh cài đặt, làm rõ đầu vào khi sử dụng, và cải thiện tính nhất quán của release note cho Technical Writing và tài liệu dành cho lập trình viên.

Skill add-educational-comments thêm các chú thích mang tính giảng giải vào tệp mã nguồn được chỉ định, đồng thời giữ nguyên cấu trúc và hành vi của mã. Skill có thể yêu cầu người dùng chọn tệp nếu chưa có, điều chỉnh mức độ giải thích theo trình độ người đọc và tuân thủ các giới hạn tăng số dòng rõ ràng khi biên tập mã cho mục đích học tập.

gws-docs giúp bạn đọc và ghi Google Docs qua `gws` CLI với mức kiểm soát theo từng method cho các thao tác tạo, lấy dữ liệu và cập nhật hàng loạt. Hãy theo luồng cài đặt, schema và cách dùng trong hướng dẫn gws-docs nếu bạn cần tự động hóa viết kỹ thuật và tài liệu.

adr-skill giúp các nhóm tạo và duy trì Architecture Decision Records để agent có thể thực thi. Công cụ này hỗ trợ soạn thảo, khởi tạo thư mục ADR, chọn template, cập nhật trạng thái và kiểm tra quyết định bằng checklist, script và ví dụ cụ thể.

Clarify giúp cải thiện UX copy khó hiểu, thông báo lỗi, nhãn, các bước onboarding và hướng dẫn để người dùng có thể hành động với ít phải đoán hơn. Skill này phù hợp cho Technical Writing, nội dung hỗ trợ và các nhóm sản phẩm cần văn bản giao diện rõ ràng hơn. Skill bắt đầu từ bối cảnh, đối tượng và trạng thái của người dùng trước khi viết lại, nhờ đó đầu ra trực tiếp hơn, cụ thể hơn và dễ dùng hơn.