mcpField
A
anki-card-generator

anki-card-generator

github.com/niraclerProductivity1154 installsUpdated 15w ago
Repository

About anki-card-generator

Anki-card-generator is a skill for creating concise Anki cards from study material, aimed at learners who want structured recall practice. It uses atomized questions and answers in simple-anki-sync Markdown, with clarification before generation when requirements are unclear.

Key features

  1. 01Clarifies scope, depth, quantity, and context
  2. 02Creates atomized recall questions and answers
  3. 03Formats cards for simple-anki-sync
  4. 04Supports detail levels and related-card references
  5. 05Checks card sets for redundancy and quality

Use cases

  1. 01Turn study notes into Anki cards
  2. 02Prepare cards for an exam or application
  3. 03Break broad topics into recall-sized units

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/niracler/skill --skill anki-card-generator

After installing, type/anki-card-generatorin Claude Code to confirm it loaded.

Bundled filesreferences/examples.md

Details

From the project README

Anki Card Generator

Generate high-quality Anki cards based on LessWrong best practices and simple-anki-sync format.

Pre-Generation Clarification

Before generating cards, clarify with user if unclear:

  1. Scope: "Which aspects to focus on?" (for broad topics)
  2. Depth: "Basic concepts only, or detailed Level 2/3 cards?"
  3. Quantity: "How many cards? (Recommend 5-10 for core concepts)"
  4. Context: "Any specific exam or application scenario?"

Proceed only after understanding requirements.

Output Format

Use simple-anki-sync format:

#anki/[domain]/[topic]

| [Question] |
| ---------- |
| [Core answer]<br><br><small>💡 [Supplementary info]</small> |
Format Options

Option A (Recommended): HTML tags

| 唐朝建立时间 |
| ---------- |
| 618年，李渊建立<br><br><small>💡 隋末农民起义后起兵</small> |

Option B: Separator

| 唐朝建立时间 |
| ---------- |
| 618年，李渊建立 ——— 💡 隋末农民起义后起兵 |

Option C: Parentheses

| 唐朝建立时间 |
| ---------- |
| 618年，李渊建立（趣闻：其子李世民功劳最大） |

Atomization Rules

Word Limits
  • English: Max 9 words, absolute limit 18 words
  • Chinese: Recommended 15-20 characters, absolute limit 30-35 characters
  • Max items: 3 bullet points per card
Core Principle

If a card can be split into two shorter cards, split it.

Question Design

Standardized Templates
  • Time: "X 时间" (not "X发生于何时？")
  • Definition: "X 定义" (not "什么是X？")
  • Person: "who X" (not "谁做了X？")
  • Pros/Cons: "X 利弊" (not "X的优势是什么？")
Key Rules
  • Match real-world recall scenarios
  • Use plain, unremarkable wording
  • Avoid words in question that appear in answer
  • Keep all critical info in answer, not question

Answer Construction

Core Answer
  • Strictly follow word limits
  • Answer should be meaningful without the question
  • All key information in answer
Supplementary Info (Optional)

Format: <br><br><small>💡 content</small>

Emoji Guide:

  • 💡 Fun fact / trivia
  • 📝 Note / explanation
  • 🔗 Related concept
  • ⚡ Tip / key point
  • 📊 Data / statistics
  • 📅 Date / timeline

Keep supplementary info to 10-20 characters.

Handle System

Use > to reference related cards:

| 牛顿贡献 |
| ------- |
| >运动定律 >万有引力 >微积分发展 |

Detail Levels

  • Level 1: Basic concept (core answer)
  • Level 2: Detailed info (supplementary section)
  • Level 3: Advanced details (create separate cards)

Tag Naming

Use English tags: #anki/[domain]/[topic]

Common domains: history, programming, language, science, mathematics, psychology, economics, philosophy, medicine, art

Quality Checklist

Per Card
  • Core answer within word limit?
  • Correct supplementary format?
  • Can it be further split?
  • Question matches real recall scenario?
  • No memory shortcuts?
  • All key info in answer?
Card Set
  • Appropriate cross-references?
  • Proper detail levels?
  • No redundancy?

Domain Examples

See references/examples.md for detailed examples:

  • History (ancient China)
  • Programming (Python)
  • Language learning (English)
  • Academic concepts (psychology)
  • Complex topics (quantum mechanics)
  • Error corrections
  • Advanced techniques (reversible cards, redundancy design)

Workflow

  1. Receive input: Knowledge points, wiki links, study materials
  2. Clarify: Ask questions if uncertain
  3. Generate: Follow atomization and best practices
  4. Output: simple-anki-sync markdown format

Core Philosophy: Prioritize sustainability and real recall scenarios over comprehensive coverage. Focus on preventing cognitive and motivational barriers.

When NOT to Use

❌ 不适合卡片化的内容：

  • 需要视觉理解的（图表、流程图）
  • 超过 50 行的代码块
  • 高度情境依赖的知识

✅ 替代方案：

  • 视觉内容 → 配图索引卡片
  • 大代码块 → 代码 Snippet 库

Comments

Markdown supported