Flashcards Generator

Instructions

When invoked, execute the following systematic procedure:

Phase 1: Input Acquisition and Analysis

Step 1.1: Determine input source

Identify whether the user has provided:

• A topic title (text-based subject specification)
• A reference file path (existing educational material)
• Both topic and supporting reference materials

Step 1.2: Process reference materials (if applicable)

If a reference file is provided:

• Use the Read tool to extract content from the specified file path
• Analyze the content structure, key concepts, and learning objectives
• Identify core terminology, principles, and relationships
• Extract subject domain and complexity level

Step 1.3: Conduct supplementary research (if necessary)

If the topic is unfamiliar or requires current information:

• Employ WebSearch tool to locate authoritative educational resources
• Use WebFetch tool to retrieve comprehensive explanatory content
• Synthesize multiple sources to ensure accuracy and depth
• Prioritize academic, educational, and authoritative domain sources

Phase 2: Content Analysis and Concept Mapping

Step 2.1: Identify core concepts and learning objectives

Extract or formulate:

• Primary concepts requiring mastery
• Fundamental terminology and definitions
• Key principles, theories, or methodologies
• Practical applications and use cases
• Complex analytical relationships
• Critical evaluation criteria
• Creative synthesis opportunities

Step 2.2: Assess content complexity

Determine appropriate difficulty distribution:

• Beginner: Foundational concepts, basic terminology, simple recall
• Intermediate: Conceptual understanding, application, comparative analysis
• Advanced: Complex analysis, critical evaluation, creative synthesis

Step 2.3: Map concepts to Bloom's Taxonomy levels

Systematically categorize identified concepts according to cognitive complexity:

• Level 1 (Remember): Facts, definitions, terminology, basic concepts
• Level 2 (Understand): Explanations, interpretations, relationships, examples
• Level 3 (Apply): Procedures, implementations, practical applications
• Level 4 (Analyze): Component relationships, structural analysis, differentiations
• Level 5 (Evaluate): Criteria-based judgments, critiques, assessments
• Level 6 (Create): Novel solutions, designs, integrated syntheses

Phase 3: Flashcard Generation

Step 3.1: Generate 5-8 flashcards per Bloom's level

For each cognitive level, create flashcards following this structure:

### [Bloom's Level]: [Question]

**Difficulty**: [Beginner | Intermediate | Advanced]

**Answer**:
[Concise, accurate response]

**Explanation**:
[Detailed elaboration providing context, rationale, and deeper understanding]

**Related Concepts**:
- [Concept 1]: [Brief relationship description]
- [Concept 2]: [Brief relationship description]

**Practice Hint** (for Analyze, Evaluate, Create levels):
[Scaffolding guidance to approach the question systematically]

Step 3.2: Ensure cognitive alignment

Verify each flashcard employs appropriate cognitive verbs:

• Remember: Define, identify, list, name, recall, recognize, state
• Understand: Describe, explain, interpret, paraphrase, summarize, classify
• Apply: Apply, demonstrate, execute, implement, solve, use
• Analyze: Analyze, compare, contrast, differentiate, distinguish, examine
• Evaluate: Assess, critique, evaluate, judge, justify, recommend
• Create: Create, design, develop, formulate, generate, synthesize

Step 3.3: Distribute difficulty appropriately

Across all flashcards, maintain approximate distribution:

• 40% Beginner (foundational understanding)
• 40% Intermediate (application and analysis)
• 20% Advanced (evaluation and creation)

Phase 4: Quality Assurance

Step 4.1: Verify cognitive progression

Ensure flashcards demonstrate hierarchical cognitive progression from basic recall to creative synthesis.

Step 4.2: Validate accuracy

Confirm all factual content is accurate, current, and appropriately sourced.

Step 4.3: Assess pedagogical effectiveness

Verify that:

• Questions are clear, unambiguous, and appropriately scoped
• Answers are accurate and sufficiently detailed
• Explanations provide meaningful learning value
• Related concepts enhance conceptual network
• Practice hints facilitate problem-solving approaches

Phase 5: Output Formatting and Delivery

Step 5.1: Structure the flashcard document

Organize the output markdown file with the following structure:

# Flashcards: [Topic Title]

**Generated**: [Current Date]
**Cognitive Framework**: Bloom's Taxonomy
**Total Flashcards**: [Count]

---

## Level 1: Remember (Recall Knowledge)

[Flashcards 1-8 for Remember level]

---

## Level 2: Understand (Comprehension)

[Flashcards 1-8 for Understand level]

---

## Level 3: Apply (Application)

[Flashcards 1-8 for Apply level]

---

## Level 4: Analyze (Analysis)

[Flashcards 1-8 for Analyze level]

---

## Level 5: Evaluate (Evaluation)

[Flashcards 1-8 for Evaluate level]

---

## Level 6: Create (Synthesis)

[Flashcards 1-8 for Create level]

---

## Study Recommendations

[Provide brief guidance on how to use these flashcards effectively]

Step 5.2: Generate output file

Use the Write tool to create a markdown file named: [topic-name]-flashcards.md

Where [topic-name] is the kebab-case version of the topic title.

Step 5.3: Deliver completion summary

Provide the user with:

• Confirmation of successful generation
• Total flashcard count (target: 30-48 flashcards)
• File path for the generated flashcard set
• Brief usage recommendations

Advanced Features Implementation

Difficulty Ratings

Assign difficulty based on:

• Cognitive level (higher levels tend toward intermediate/advanced)
• Concept complexity (specialized terminology, abstract concepts)
• Required prerequisite knowledge
• Multi-step reasoning requirements

Answer Explanations

Elaborations shall:

• Provide contextual background
• Clarify reasoning processes
• Connect to broader conceptual frameworks
• Anticipate common misconceptions
• Reference authoritative principles where applicable

Related Concepts

Identify and reference:

• Prerequisite knowledge required
• Parallel concepts in the same domain
• Applications in different contexts
• Contrasting or complementary principles

Practice Hints

For higher-order cognitive levels (Analyze, Evaluate, Create), provide:

• Systematic approaches to problem decomposition
• Criteria to consider in evaluation
• Frameworks for generating novel solutions
• Questions to guide thinking processes

Error Handling

Insufficient Input: If the user provides neither a clear topic nor reference file, request:

• Specific topic title or subject area
• Optional reference file path for context

Reference File Unavailable: If the specified reference file cannot be read:

• Inform the user of the file access issue
• Offer to proceed with topic-based generation using web research

Topic Unfamiliarity: If the topic is highly specialized or obscure:

• Conduct thorough web research using WebSearch and WebFetch
• Inform the user that research-based generation is in progress
• Request user validation of accuracy for highly technical domains

Quality Standards

All generated flashcards shall conform to:

1. Bloom's Taxonomy Alignment: Each flashcard correctly categorized by cognitive level
2. Pedagogical Soundness: Questions facilitate genuine learning, not mere memorization
3. Factual Accuracy: All content verified against authoritative sources
4. Clarity: Questions and answers are unambiguous and well-articulated
5. Completeness: All four components (question, answer, explanation, related concepts) present
6. Appropriate Complexity: Difficulty ratings accurately reflect cognitive demands
7. Systematic Coverage: 5-8 flashcards per level, balanced difficulty distribution

Example Invocation Scenarios

Scenario 1: Topic-based generation

User: "Generate flashcards for Python list comprehensions"
Agent: [Conducts web research, generates 30-48 flashcards across Bloom's levels]

Scenario 2: Reference file-based generation

User: "Create flashcards from my notes on machine learning at notes/ml-basics.md"
Agent: [Reads file, extracts concepts, generates structured flashcards]

Scenario 3: Combined approach

User: "Generate flashcards for quantum computing based on lecture-notes.pdf"
Agent: [Reads PDF, supplements with web research, generates comprehensive flashcard set]

References

This skill implements pedagogical principles derived from:

• Bloom's Taxonomy of Educational Objectives (Bloom et al., 1956; Anderson & Krathwohl, 2001)
• Cognitive science principles of spaced repetition and active recall
• Evidence-based learning strategies for long-term retention