anki-card-creator

Files (5)

• SKILL.md
• _meta.json
• anki_cards.txt
• requirements.txt
• main.py · scripts/

SKILL.md (first lines)

# Anki Card Creator

## Overview

Intelligent flashcard generation tool that transforms medical study materials into Anki-compatible cards optimized for long-term retention through evidence-based spaced repetition.

**Key Capabilities:**
- **Multi-Format Input**: PDF textbooks, lecture slides, notes, web articles
- **Card Type Selection**: Basic, reversible, cloze deletion, image occlusion
- **Spaced Repetition Optimization**: Cards formatted for optimal review intervals
- **Automated Tagging**: Hierarchical organization by subject and topic
- **Media Integration**: Auto-download and embed relevant images
- **Batch Processing**: Convert entire chapters or courses efficiently

## When to Use

**✅ Use this skill when:**
- Preparing for medical board exams (USMLE, MCAT, specialty boards)
- Memorizing drug names, mechanisms, and side effects
- Learning anatomy structures and relationships
- Retaining biochemical pathways and reactions
- Creating pathology differential diagnosis cards
- Converting lecture notes to active recall format
- Building comprehensive review decks from textbooks

**❌ Do NOT use when:**
- Learning conceptual understanding → Use textbooks/videos first
- Memorizing without context → Ensure comprehension before card creation
- Creating cards for rapidly changing information → Use current resources
- Substituting clinical experience → Cards supplement, not replace practice
- Complex procedural skills → Use simulation or hands-on training

**Integration:**
- **Upstream**: `abstract-summarizer` (textbook chapter condensation), `pdf-text-extractor` (content extraction)
- **Downstream**: `anki-sync-server` (cloud backup), `study-schedule-optimizer` (review planning)

## Core Capabilities

### 1. Cloze Deletion Generation

Create fill-in-the-blank cards from dense text:

```python
from scripts.card_creator import AnkiCardCreator

creator = AnkiCardCreator()

# Generate cloze cards from text
text = """
Acute inflammation is characterized by five cardinal signs: 
redness (rubor), heat (calor), swelling (tumor), pain (dolor), 
and loss of function (functio laesa). These result from 
vasodilation, increased vascular permeability, and leukocyte 
infiltration.
"""

cards = creator.create_cloze_cards(
    text=text,
    n_cards=3,  # Generate 3 cards from this text
    difficulty="intermediate",
    tags=["Pathology", "Inflammation", "General_Pathology"]
)

# Output format (Anki-compatible)
# Card 1: "Acute inflammation is characterized by {{c1::five}} cardinal signs..."
# Card 2: "...signs: {{c1::redness}} (rubor), {{c2::heat}} (calor)..."
```

**Cloze Strategies:**
| Strategy | Use Case | Example |
|----------|----------|---------|
| **Single Deletion** | Key facts | "The {{c1::liver}} is the largest internal organ" |
| **Multiple Deletions** | Lists/groups | "CRAB symptoms: {{c1::Calcium}}, {{c2::Renal}}, {{c3::Anemia}}, {{c4::Bone}}" |
| **Hierarchical** | Progressive detail | "{{c1::Metformin}} is a {{c2::biguanide}} that {{c3::decreases hepatic glucose production}}" |

### 2. Basic and Reversible Cards

Generate question-answer pairs:

```python
# Create basic cards
cards = creator.create_basic_cards(
    content={
        "What is the mechanism of action of penicillin?": 
            "Inhibition of bacterial cell wall synthesis by binding to PBPs",
        "What are the major side effects of ACE inhibitors?":
            "Dry cough, hyperkalemia, angioedema, hypotension"
    },
    reversible=True,  # Create reverse cards too
    tags=["Pharmacology", "Antibiotics"]
)
```

**Card Types:**
- **Basic**: Question → Answer
- **Reversible**: Both directions (Q→A and A→Q)
- **Type-in**: Student types answer for active recall
- **Hint Cards**: Progressive disclosure with hints

### 3. Image Occlusion Cards

Create visual learning cards from diagrams:

```python
# Image occlusion for anatomy
cards = creator.create_image_occlusion(
    image_path="brachial_plexus.png",
    occlude_regions=[
        {"label": "Musculocutaneous nerve", "coords": (120, 200, 200, 240)},
        {"label": "Median nerve", "coords": (300, 250, 380, 290)},
        {"label": "Ulnar nerve", "coords": (400, 280, 480, 320)}
    ],
    card_type="one_by_one"  # or "all_at_once"
)
```

**Occlusion Types:**
- **One by One**: Reveal structures progressively
- **All at Once**: Identify all occluded regions

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills