anki

Anki Flashcard Management

Use the anki.sh script to create and manage flashcards via AnkiConnect.

ANKI="$(dirname "$SKILL_PATH")/scripts/anki.sh"

Preflight:

• Ensure Anki desktop is running with AnkiConnect enabled
• Ensure curl and jq are available in PATH

CRITICAL: User Approval Required

NEVER add cards to Anki without explicit user approval.

Before adding any cards:

1. Display all proposed cards in full (front + back)
2. Ask user to confirm: "Ready to add these cards?"
3. Only proceed after explicit "yes" / approval

This is non-negotiable. Users must review card quality before adding.

For potentially destructive or irreversible actions:

• delete: ask explicit confirmation before deleting notes
• update: confirm exact fields/IDs before updating notes
• rate: show card + suggested rating, then wait for user confirmation before submitting

Guidelines

• MUST use the Anki Markdown note type for basic cards or Anki Markdown Cloze for cloze deletions
• Use markdown for both front and back fields
• Test exactly one fact or idea per card
• Make questions atomic and simple
• Keep questions and answers short, clear, and unambiguous
• Ensure each card has one unique, specific answer
• Avoid long lists or multiple items in one card
• Add context or hints so your future self understands
• Personalize with examples or mnemonics if helpful
• Allow multiple simple cards for important concepts
• Create multiple variants of important questions from different angles
• Connect cards to personal goals and projects to avoid "orphan" facts
• Always use syntax highlighting for code (see Code Snippets section)
• When creating multiple related cards, use bulk operations for efficiency

Choosing Card Type

Use Anki Markdown (Front/Back) for question-answer pairs where you write a specific question. Use Anki Markdown Cloze (Text/Extra) for fill-in-the-blank cards where hiding parts of a statement is more natural than writing a question.