learn-notes
Skill2 starsChanged 4 months agoMITView on GitHub
Manage a structured learning notes system (LEARN.md + learns/ folder) that helps non-technical users accumulate knowledge over time. Use this skill whenever the user says anything related to learning notes, updating LEARN, writing a summary of what was done, recording what was learned, or reviewing past notes. Also trigger when a task or project is completed and the user asks to document it. Trigger phrases include: "更新 LEARN", "寫學習筆記", "update learn", "記錄一下", "幫我整理筆記", "我學到了什麼", "做一下筆記", "做筆記", "做個筆記", "筆記一下", "幫我筆記", "note this down", "take notes", "review my notes", "複習", "查 LEARN". Even if the user just says "筆記" or "learn" in the context of wrapping up a task, use this skill. IMPORTANT: when the user mentions 筆記/notes in ANY form, it ALWAYS means this LEARN.md + learns/ file system in the project — NEVER Claude's internal persistent memory. Do not write to Claude's memory directory in response to note-taking requests.
In this repository11 other files it gives its agents.
- codelab-handoutSkill
- course-handoutSkill
- hackmd-noteSkill
- humanizer-zh-twSkill
- interpreting-stock-moodSkill
- music-disc-videoSkill
- paper-language-passSkill
- survey-designSkill
- teaching-handbookSkill
- tw-namingSkill
- video-researchSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. About 0 are common, 7 are distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 42
If LEARN.md doesn't exist yet, create it with this template:
- Distinctive: line 56
When adding a new entry, append a row to the table.
- Distinctive: line 71
Write in the user's language (default: 繁體中文, unless the user prefers otherwise)
- Distinctive: line 73
Use metaphors liberally (e.g., "API 就像餐廳的菜單,你看菜單點菜,廚房幫你做好送出來")
- Distinctive: line 75
Keep paragraphs short — walls of text are intimidating
- Distinctive: line 76
Use tables, bullet points, and headers to break up content
- Very specific: line 78
Obsidian links: Use [[雙括號連結]] for tools, technologies, and concepts mentioned in notes (e.g., [[Claude Code]], [[Google Sheets]], …
- Distinctive: line 82
When the user asks to review their notes:
- Very specific: line 83
Read LEARN.md to get the full index
- Distinctive: line 85
Ask which topic they'd like to dive into, or offer a quick recap of recent notes
- Very specific: line 86
Read the relevant file(s) from learns/ and summarize the key points
- Very specific: line 90
If neither LEARN.md nor learns/ exist:
- Very specific: line 91
Create the learns/ directory
- Very specific: line 92
Create LEARN.md with the template above
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Learn Notes — 學習筆記系統
You are managing a learning notes system for a user who is NOT technical. All notes must be written in plain, engaging language — no dry textbook tone. Use metaphors, analogies, and fun anecdotes to make concepts stick.
System Structure
project-root/
├── LEARN.md ← Index page (table of contents)
├── learns/
│ ├── YYYYMMDD_topic-A.md
│ ├── YYYYMMDD_topic-B.md
│ └── ...LEARN.md(in project root) = Index page. A markdown table listing all notes by date, topic, file link, and a one-line summary.learns/folder = Detailed notes. One file per topic. Filename format:YYYYMMDD_topic.md(e.g.,20260311_claude設定.md).
When to Create / Update Notes
Trigger note creation when:
- The user explicitly asks (e.g., "更新 LEARN", "幫我寫筆記")
- A task or project has been completed and the user wants to document it
How to Write the Index (LEARN.md)
If LEARN.md doesn't exist yet, create it with this template:
# LEARN.md — 我的學習筆記目錄
> 這是目錄頁,詳細內容請看 `learns/` 資料夾裡的各篇筆記。
> 想複習時,跟 Claude 說「幫我查 LEARN」就好!
---
| 日期 | 主題 | 筆記檔案 | 一句話摘要 |
|------|------|----------|-----------|When adding a new entry, append a row to the table. Do not overwrite existing rows.
How to Write a Detailed Note (learns/*.md)
Each note file should include:
- Title — Date and topic as the heading
- 我們做了什麼? — What was accomplished, in plain language
- 為什麼這樣做? — The reasoning behind key decisions
- 學到的小知識 — Bite-sized takeaways the user can remember
- 遇到的問題與解決方式 (if applicable) — Mistakes, bugs, and how they were fixed. Explain the "why" so the user can recognize similar issues in the future
- 未來小提醒 (if applicable) — Pitfalls to watch out for, best practices
Writing Style Rules
- Write in the user's language (default: 繁體中文, unless the user prefers otherwise)
- Explain technical terms like you're talking to a smart friend who has never coded
- Use metaphors liberally (e.g., "API 就像餐廳的菜單,你看菜單點菜,廚房幫你做好送出來")
- Include fun analogies or real-world comparisons to make concepts memorable
- Keep paragraphs short — walls of text are intimidating
- Use tables, bullet points, and headers to break up content
- The tone should feel like a knowledgeable friend explaining things over coffee, not a professor lecturing
- Obsidian links: Use
[[雙括號連結]]for tools, technologies, and concepts mentioned in notes (e.g.,[[Claude Code]],[[Google Sheets]],[[Gemini]],[[Python]]). This enables knowledge graph visualization when imported into Obsidian. Do NOT add links inside headings, code blocks, or URLs.
How to Handle "Review" / "複習" Requests
When the user asks to review their notes:
- Read
LEARN.mdto get the full index - Present the list of topics with summaries
- Ask which topic they'd like to dive into, or offer a quick recap of recent notes
- Read the relevant file(s) from
learns/and summarize the key points
First-Time Setup
If neither LEARN.md nor learns/ exist:
- Create the
learns/directory - Create
LEARN.mdwith the template above - Inform the user that the system has been set up and explain briefly how it works
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
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.

