Clarity

writing-clearly-and-concisely là một skill biên tập có thể tái sử dụng để viết lại các nội dung văn bản dành cho người đọc. Skill này giúp biến những bản nháp dài dòng, mơ hồ hoặc mang giọng điệu giống AI thành tiếng Anh đơn giản, trực diện cho tài liệu, README, commit message, mô tả PR, thông báo lỗi, UI copy, báo cáo và phần giải thích. Repo kết hợp các nguyên tắc rõ ràng theo phong cách Strunk với hướng dẫn thực tế để tránh kiểu diễn đạt hoa mỹ, phồng chữ thường thấy ở văn bản do AI tạo ra.

requirements-clarity là một quy trình làm việc có cấu trúc, giúp biến các yêu cầu tính năng còn mơ hồ thành bộ yêu cầu sẵn sàng để triển khai. Skill này phát hiện phần phạm vi còn thiếu, ràng buộc, tiêu chí chấp nhận, edge case và bối cảnh kỹ thuật, sau đó đặt câu hỏi trọng tâm theo từng vòng để tạo ra đầu ra kiểu PRD rõ ràng hơn trước khi bắt đầu viết code.

naming-analyzer rà soát tên biến, hàm, lớp, file, trường cơ sở dữ liệu và API; đánh dấu các identifier mơ hồ hoặc dễ gây hiểu nhầm, đồng thời gợi ý phương án đặt tên rõ ràng hơn, phù hợp quy ước cho review code và refactor.