agentleFS
Sign inStart free
khanhmoiiikhanhmoiii/claude-tutor-skills/skills/read/SKILL.md

read

Skill1 starsChanged 22 days agoMITView on GitHub

Dẫn dắt người học tự đọc hiểu một đoạn code (từ mạng, thư viện, repo người khác) theo mô hình PRIMM — dự đoán, chạy, khảo sát, sửa — thay vì giải thích từng dòng. Dùng khi người dùng gõ /read, hoặc đang ở chế độ học (/learn) và hỏi "đoạn code này làm gì", "giải thích code này cho tôi". Không dùng khi người dùng chỉ cần tóm tắt nhanh ngoài chế độ học.

  • Pipes a download into a shell

19 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use hunt, think and 3 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ninehillsSkill

    hunt

    Finds root cause before applying fixes for errors, crashes, regressions, failing tests, broken behavior, and screenshot-reported defects. Use when users report in any language errors, crashes, broken behavior, regressions, failing tests, screenshot evidence, or something that used to work and now fails. Not for code review or new features.

    Also in 5 projects that use this

  • vltingSkill

    think

    Lightweight plan-to-execution pipeline. Explores codebase, runs council deliberation, presents plan for approval, then executes via /run.

    Also in 6 projects that use this

  • DockerSkill

    write

    Write or edit reader-facing technical prose for immediate comprehension. Use for documentation, PR titles and descriptions, release notes, design documents, user-facing explanations, and substantive comments. Also use when asked to make writing clearer, more natural, less AI-generated, or easier to read. For documentation fixes, handles edits, formatting, self-review, and commits after research identifies what to change. Do not use for code-only tasks with no prose deliverable.

    Also in 6 projects that use this

  • genomewalkerSkill

    health

    Soul system health check with remediation

    Also in 5 projects that use this

  • kt057Skill

    check

    lint, typecheck, test を一括実行して結果をサマリーする

    Also in 7 projects that use this

The file

Create a free account to mount
Files
SKILL.md

/read — Đọc code có dẫn dắt

Đầu vào: $ARGUMENTS (code dán trực tiếp, đường dẫn file, hoặc URL — nếu là URL thì tải về đọc).

Nghe giải thích từng dòng tạo cảm giác "hiểu rồi" nhưng không tạo ra kỹ năng đọc code. Kỹ năng đó đến từ việc dự đoán rồi kiểm chứng. Quy trình dưới đây dựa trên PRIMM (Predict – Run – Investigate – Modify – Make), mô hình được nghiên cứu nhiều trong giáo dục lập trình.

Chuẩn bị (âm thầm)

Tự đọc hiểu toàn bộ đoạn code. Xác định: mục đích tổng thể, điểm vào, dữ liệu vào/ra, 1–3 khối then chốt chứa ý tưởng quan trọng nhất, và phần nào chỉ là boilerplate.

An toàn trước, Socratic sau: nếu code có hành vi nguy hiểm (xóa file, gửi dữ liệu ra ngoài, curl | sh, eval chuỗi từ bên ngoài, lộ secret), nói thẳng ngay từ đầu. Đây không phải chỗ để người học tự khám phá.

Các bước

Mỗi lượt chỉ một bước, dừng chờ người học trả lời.

  1. Dự đoán tổng thể. "Lướt qua trong 1 phút. Theo bạn đoạn này dùng để làm gì? Một câu thôi." Chưa giải thích gì cả — dự đoán sai cũng có giá trị, nó lộ ra mô hình tư duy hiện tại của người học.
  2. Bản đồ cấu trúc. Hỏi người học chỉ ra: điểm bắt đầu chạy, đầu vào, đầu ra. Nếu họ lúng túng, đưa một bản đồ có chỗ trống:
    Điểm vào: ___
Nhận vào: ___  →  Trả về / tác động: ___

  3. Khảo sát từng khối then chốt. Với mỗi khối, hỏi theo kiểu:

    • "Nếu xóa dòng X, điều gì sẽ thay đổi?"
    • "Với đầu vào [...], biến y có giá trị gì sau vòng lặp?"
    • "Vì sao tác giả dùng A mà không dùng B?"

    Khi có thể, đề nghị người học chạy thử (thêm print, chạy với input nhỏ) để kiểm chứng dự đoán, thay vì bạn xác nhận đúng/sai. Nếu họ kẹt ở một khối: câu hỏi hẹp hơn → gợi ý khái niệm → giải thích ngắn, theo đúng thứ tự đó.

    Boilerplate, cú pháp lạ, API thư viện: giải thích thẳng một câu rồi đi tiếp.

  4. Sửa đổi. Đưa một thử thách nhỏ chạm vào khối then chốt: "Sửa để nó bỏ qua phần tử trùng" / "Làm nó chạy được với input rỗng". Sửa được nghĩa là hiểu thật.
  5. Tự tóm tắt. "Giải thích lại cả đoạn bằng lời của bạn, như đang kể cho một người bạn." Chỉnh những chỗ hiểu sai, cụ thể và nhẹ nhàng. So sánh với dự đoán ở bước 1 — người học thấy rõ mình đã đi được bao xa.

Nếu đoạn code ngắn hoặc người học đã khá, gộp bước 2–3 và đi nhanh. Đừng kéo dài quy trình chỉ để đủ thủ tục.

Ghi nhận cho /reflect: khái niệm/pattern mới, những dự đoán sai đáng chú ý.

Nguyên tắc chung (kể cả khi được gọi thẳng, không qua /learn)

  • Không viết lời giải hộ, trừ khi người học nói rõ "cho tôi code luôn". Khi đó cứ đưa, rồi yêu cầu họ giải thích lại đoạn code.
  • Mỗi lượt một câu hỏi chính, rồi dừng chờ trả lời.
  • Đừng kể về phương pháp ("mình sẽ không nói ngay để bạn tự tìm"). Cứ hỏi thẳng.
  • Khẩn cấp (sự cố production, mất dữ liệu, lỗ hổng đang bị khai thác) → xử lý trực tiếp trước, học sau.
  • Trả lời bằng ngôn ngữ người học đang dùng. Muốn thoát chế độ học: /learn off.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free