📝 note-organizer

A Claude Code skill that transforms raw lecture transcripts and study notes into clean, structured Markdown files — faithfully, without adding anything that wasn't there.

✨ What it does

🚀 How to trigger

Just say any of the following in Claude Code:

帮我整理上传的笔记
整理这份笔记
帮我清理这些课堂记录
把这个录音稿整理成笔记
help me organize my notes
clean up this lecture transcript
turn this recording into notes

Or simply upload a .docx / .md / .txt file — the skill activates automatically.

🔄 5-Step Workflow

  ┌─────────────┐
  │  1. INPUT   │  .docx / .md / .txt / pasted text
  └──────┬──────┘
         │
  ┌──────▼──────┐
  │  2. DENOISE │  Remove filler words, classroom chatter, garbled segments
  └──────┬──────┘
         │
  ┌──────▼──────┐
  │ 3. EXTRACT  │  Identify definitions, principles, steps, conclusions, comparisons
  └──────┬──────┘
         │
  ┌──────▼──────┐
  │ 4. STRUCTURE│  Organize into H2 / H3 hierarchy from original headings
  └──────┬──────┘
         │
  ┌──────▼──────┐
  │  5. OUTPUT  │  Save as 课程笔记_[topic].md, report compression ratio
  └─────────────┘

🛡️ Core Principle

Faithful organization, not rewriting.

• Every output sentence can be traced back to the original text
• No added explanations, examples, or background knowledge
• No paraphrasing or abstract summaries of the author's intent
• Skips non-knowledge segments silently — no "this section omitted" notes

📋 What gets filtered out

📦 Supported Input Formats

• .docx — Word documents (extracted via Python stdlib)
• .md — Markdown files
• .txt — Plain text
• Pasted text — directly in the chat

Large file handling: If the input exceeds ~8,000 characters, the skill warns you and suggests splitting into segments before proceeding.

💾 Output Format

课程笔记_[主题或日期].md

• Top-level heading: # 课程笔记
• Body uses H2 / H3 only — no deeper nesting
• Tables, code, and formulas use proper Markdown syntax
• After saving, reports: original word count → output word count (compression ratio)

🔧 Installation

Copy SKILL.md to your Claude Code global skills directory:

mkdir -p ~/.claude/skills/note-organizer
cp SKILL.md ~/.claude/skills/note-organizer/SKILL.md

That's it — Claude Code picks it up automatically on next launch.

📄 License

MIT