write-for-cold-reader
任何最終會被人讀到的產出——程式碼註解、commit message、PR/MR 留言、設計文件、教學筆記、code review finding、session 回話——都要讓讀者只憑他手上真的有的東西讀懂。三條規則：① 只引用讀者手上有的東西（不准指…
Skill by lystyp
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/lystyp-write-for-cold-reader
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: writing
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/write-for-cold-reader
What's inside
- Skill name
write-for-cold-reader- Description
- 任何最終會被人讀到的產出——程式碼註解、commit message、PR/MR 留言、設計文件、教學筆記、code review finding、session 回話——都要讓讀者只憑他手上真的有的東西讀懂。三條規則：① 只引用讀者手上有的東西（不准指 .md、不准用只活在對話裡的自創詞、不准提被砍掉的符號或還沒落地的計畫）——只在讀者不在場的載體（註解／commit／文件）全開；② 逐句過「讀到這句會不會冒問號」測試（名詞要 grep 得到、結論寫死、修正句不擺句尾）；③ 解釋要給機制不給生活類比，出現讀者可能不熟的名詞就當場展開。②③ 連 session 回話都適用，因為對方拿得到對話、拿不到你腦裡讀過卻沒說出口的東西。當你正要寫任何一段人類會讀的文字時就套用，不需要使用者明說「寫清楚一點」。
- License
- unknown
- Instructions
- 242 lines in SKILL.md · view on GitHub
Files (1)
- SKILL.md
The license isn't open source, so the instructions aren't shown here. Read SKILL.md on GitHub
More from lystyp/useful-skill
- 0.551score
explain-code-flow
lystyp
替一份改動（工作區 diff、branch、MR／PR）排一條「從最外層入口一路往下讀」的閱讀路線，每站附可點的檔案:行號與這站要看什麼。使用者說「我要讀這次的修改」「從入口往下讀要怎麼讀」「帶我讀這個 diff」「這些改動要從哪裡開始看」時使用。
SkillAFreshness: AClaude Code +9 - 0.548score
explain-mr
lystyp
白話具體詳細說明一份改動（本地 branch、GitLab MR、GitHub PR）在幹嘛、為什麼要做。使用者問「這隻 branch 在幹嘛」「這個 MR 在做什麼」「說明一下這個 PR」時使用。
SkillAFreshness: AClaude Code +9 - 0.520score
isolated-worktree-session
lystyp
隔離工作流：從當前 HEAD 切 temp branch、在 repo root 外開 worktree（帶 .env、複製當前對話讓新視窗可 resume）、session 嚴格鎖定只在 worktree 內活動、結束時詢問是否 cherry-pick 回原 branch 再清理。使用者輸入…
SkillBFreshness: BClaude Code +9 - 0.516score
debug-patches
lystyp
把「只在本機／測試環境才要有」的 debug 改動（例如印出 req/res body）套進當前 repo，並單獨包成一個 temp commit，測完可以整包丟掉。也負責維護這份 debug 改動清單：使用者說「再加一個測試用改動」「記下這個 debug patch」時，把新的一筆寫進 catalog。觸發：套…
SkillBFreshness: BClaude Code +9 - 0.474score
design-sparring-partner
lystyp
跟使用者在他的程式碼專案做「非瑣碎」開發時，AI 該採用的協作姿態。 當要實作新功能 / 模組、做建模・抽象・型別・分層・架構決策、改既有 code、或一起 review 設計時務必觸發—— 即使他只說「幫我做 X」「幫我看一下」沒提到「協作」「設計」。核心六件事： ① 先診斷對齊、不要急著產…
SkillCFreshness: CClaude Code +9 - 0.474score
jira
lystyp
用 Jira Cloud REST API v3 查詢與操作 issue。當使用者提到 Jira、要建立 / 更新 / 查詢 issue、跑 JQL、加 comment、轉狀態（transition / 移到 Done / In Progress）、貼一個 Jira issue 連結或 issue key（如…
SkillCFreshness: CClaude Code +9 - 0.471score
useful-tools
lystyp
Daniel 的實用工具設定集——每個工具一份 reference 文件，內含完整設定步驟、原理解說與踩雷排查。當使用者想「設定／重建／排查」以下工具時觸發：claude-code-notifications（Claude Code 的 macOS 通知，含兩種：Stop 事件的「回覆完成通知」與…
SkillCFreshness: CClaude Code +9 - 0.469score
learn-from-known
lystyp
用「從已知推導未知」的依賴關係優先教學法帶使用者學習任何新主題，並維護兩份 Markdown 檔：大綱檔（進度追蹤＋各階段追問清單）與 summary 檔（每階段完成後的完整知識筆記），隨進度持續更新。當使用者說「教我」「我想學」「幫我理解」某個概念或主題、想循序漸進地搞懂某個東西、或希望追蹤自己學到哪裡時，就使用這…
SkillCFreshness: CClaude Code +9 - 0.467score
code-review
lystyp
逐項 review 一份改動——本地 branch diff、GitHub PR、GitLab MR、或指定路徑皆可。先讀懂改動目的，再把 12 個面向（可讀性 / 註解 / DRY / 單一職責 / 耦合內聚 / 擴充性 / 函式控制流 / 型別與資料形狀 / 錯誤處理 / API 健壯性 /…
SkillCFreshness: CClaude Code +9 - 0.467score
pr-inline-comment
lystyp
在 GitHub PR 或 GitLab MR 的指定程式碼行上發、改、刪 inline review comment。處理 commit SHA 取得、行號錨定（新增／刪除／未變動行各有規則）、以及「行號必須以整數送出」這個會讓留言被靜默降級成一般留言的踩雷點。
SkillCFreshness: CClaude Code +9 - 0.464score
review-finding-format
lystyp
Code review 問題的呈現格式規範——每項含位置、問題、🗣️ 白話情境（用具體小例子演一遍怎麼踩到，以「預期 vs 實際」收尾）、建議解法。當要輸出 review 結果、寫 PR/MR 留言、或把技術問題解釋給非作者看時使用。
SkillCFreshness: CClaude Code +9 - 0.461score
commit
lystyp
根據 git staged/unstaged changes 撰寫 commit 訊息並提交
SkillCFreshness: CClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Aug 11, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- License unknown
- Repository
- github.com/lystyp/useful-skill
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from lystyp
- 0.551score
explain-code-flow
lystyp
替一份改動（工作區 diff、branch、MR／PR）排一條「從最外層入口一路往下讀」的閱讀路線，每站附可點的檔案:行號與這站要看什麼。使用者說「我要讀這次的修改」「從入口往下讀要怎麼讀」「帶我讀這個 diff」「這些改動要從哪裡開始看」時使用。
SkillAFreshness: AClaude Code +9 - 0.548score
explain-mr
lystyp
白話具體詳細說明一份改動（本地 branch、GitLab MR、GitHub PR）在幹嘛、為什麼要做。使用者問「這隻 branch 在幹嘛」「這個 MR 在做什麼」「說明一下這個 PR」時使用。
SkillAFreshness: AClaude Code +9 - 0.520score
isolated-worktree-session
lystyp
隔離工作流：從當前 HEAD 切 temp branch、在 repo root 外開 worktree（帶 .env、複製當前對話讓新視窗可 resume）、session 嚴格鎖定只在 worktree 內活動、結束時詢問是否 cherry-pick 回原 branch 再清理。使用者輸入…
SkillBFreshness: BClaude Code +9 - 0.516score
debug-patches
lystyp
把「只在本機／測試環境才要有」的 debug 改動（例如印出 req/res body）套進當前 repo，並單獨包成一個 temp commit，測完可以整包丟掉。也負責維護這份 debug 改動清單：使用者說「再加一個測試用改動」「記下這個 debug patch」時，把新的一筆寫進 catalog。觸發：套…
SkillBFreshness: BClaude Code +9 - 0.474score
design-sparring-partner
lystyp
跟使用者在他的程式碼專案做「非瑣碎」開發時，AI 該採用的協作姿態。 當要實作新功能 / 模組、做建模・抽象・型別・分層・架構決策、改既有 code、或一起 review 設計時務必觸發—— 即使他只說「幫我做 X」「幫我看一下」沒提到「協作」「設計」。核心六件事： ① 先診斷對齊、不要急著產…
SkillCFreshness: CClaude Code +9 - 0.474score
jira
lystyp
用 Jira Cloud REST API v3 查詢與操作 issue。當使用者提到 Jira、要建立 / 更新 / 查詢 issue、跑 JQL、加 comment、轉狀態（transition / 移到 Done / In Progress）、貼一個 Jira issue 連結或 issue key（如…
SkillCFreshness: CClaude Code +9
Cite this page
write-for-cold-reader skill. Agent Mart. https://agentmart.dev/skills/lystyp-write-for-cold-reader (last updated 2026-10-24)