Bộ tối ưu CLAUDE.md theo Progressive Disclosure

Cung cấp những gì

Skill này biến việc "làm gọn CLAUDE.md" thành một quy trình kỹ thuật có kiểm chứng:

• Đo trước, sửa sau: xem tỷ lệ chiếm context bằng /context, bảng byte theo từng heading, phân bố dòng khổng lồ, và giới hạn cắt của các công cụ đọc cùng tệp (Codex project_doc_max_bytes mặc định 32KiB — phần vượt bị ẩn im lặng).
• Phân loại tín hiệu: câu hỏi chuẩn là "xoá dòng này thì Claude có làm sai không?". Nội dung suy ra được từ code, quy ước ngôn ngữ, hay kiến thức hiển nhiên là phản tín hiệu → chỉ xoá sau khi người dùng xác nhận.
• Di chuyển nguyên văn, cấm nén: chuyển sang Level 2 phải copy y nguyên; nhiều mục thì dùng scripts/sink_sections.py (tự kiểm tra chuỗi đầy đủ, thất bại thì rollback).
• Bảng chọn vật mang: quy tắc nên nằm ở Level 1 thường trú, reference, Skill, Hook (chặn/tiêm), hay .claude/rules/ với paths:.
• Ba bước xác minh: tệp reference tồn tại (5a), toàn vẹn nội dung (5b — mặc định dùng sub-agent độc lập kiểm tra), và số dòng không phải tiêu chí (5c).
• Cảnh báo bẫy của chính công cụ kiểm tra: grep -F với câu gốc nhiều dòng bị suy biến thành OR theo dòng → báo đúng dù đã mất nửa đoạn; khác biệt symlink, ký tự regex, bash vs zsh đều được thực nghiệm.

Phù hợp với ai

• Người có CLAUDE.md phình to đến mức Claude bắt đầu bỏ qua các quy tắc
• Người muốn dọn tài liệu mà tuyệt đối không mất thông tin quan trọng
• Team lẫn lộn giữa ~/.claude/CLAUDE.md (toàn cục) và CLAUDE.md của từng dự án
• Ai dùng Codex/công cụ khác đọc chung tệp và lo bị cắt ngầm

Ví dụ sử dụng

1. "CLAUDE.md của tôi dài quá?" → skill trả lời bằng cách reframe (số dòng không phải mục tiêu), rồi xuất bảng byte theo mục để xử lý phần lớn nhất trước.
2. Dọn tệp toàn cục 168KB → phát hiện nó chiếm 69% context lúc khởi động, hạ 10 mục SOP ít dùng xuống ~/.claude/references/ nguyên văn, kèm bảng chỉ mục có điều kiện kích hoạt ở đầu và cuối.
3. Truy tìm "con trỏ giả" → dòng "xem chi tiết tại anti-patterns.md" nhưng tệp đó không hề chứa nội dung; skill phát hiện bằng grep chuỗi đặc thù + so khớp toàn chuỗi bằng python3.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục daymade-claude-code/claude-md-progressive-disclosurer từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/claude-md-progressive-disclosurer/ 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.