AgentSkillsCN

notes-generator

按照布卢姆分类学方法生成适合初学者的教育笔记。适用于需要根据主题标题或参考文件创建结构化学习材料,通过记忆、理解、应用、分析、评价和创造等认知层次组织内容时使用。

SKILL.md
--- frontmatter
name: notes-generator
description: Generate beginner-friendly educational notes following Bloom's Taxonomy methodology. Use when you need to create structured learning materials from a topic title or reference file, organizing content through Remember, Understand, Apply, Analyze, Evaluate, and Create cognitive levels.
allowed-tools: Read, Write, Glob, Grep, WebSearch

Notes Generator

Generate structured educational notes following Bloom's Taxonomy for effective learning progression.

Instructions

Step 1: Gather Input

  1. Check if the user provided a reference file path

    • If yes: Read the file content to extract key concepts
    • If no: Use the provided topic title as the basis
  2. Identify the subject matter and scope of the topic

Step 2: Research (if needed)

If the topic requires additional context or the reference file is insufficient:

  • Use WebSearch to gather foundational information
  • Focus on beginner-friendly explanations and examples

Step 3: Generate Notes Structure

Create notes following Bloom's Taxonomy levels (beginner-friendly approach):

Level 1: Remember (Foundation)

  • Purpose: Basic recall of facts and concepts
  • Content to include:
    • Key definitions and terminology
    • Important facts and figures
    • Basic concepts and principles
    • Memory aids (mnemonics, acronyms)

Level 2: Understand (Comprehension)

  • Purpose: Demonstrate understanding of ideas
  • Content to include:
    • Explanations in simple language
    • Real-world analogies and comparisons
    • Visual descriptions or diagrams (text-based)
    • Summaries of main ideas

Level 3: Apply (Practice)

  • Purpose: Use knowledge in new situations
  • Content to include:
    • Step-by-step procedures
    • Practical examples
    • Simple exercises or problems
    • Common use cases

Level 4: Analyze (Break Down)

  • Purpose: Break information into parts
  • Content to include:
    • Comparisons and contrasts
    • Cause and effect relationships
    • Pattern identification
    • Component breakdown

Level 5: Evaluate (Judge)

  • Purpose: Make judgments based on criteria
  • Content to include:
    • Pros and cons lists
    • When to use vs. when not to use
    • Common mistakes to avoid
    • Best practices

Level 6: Create (Synthesize)

  • Purpose: Produce new or original work
  • Content to include:
    • Mini-project ideas
    • Creative exercises
    • Extension activities
    • "Try it yourself" challenges

Step 4: Format the Notes

Use this Markdown template:

markdown
# [Topic Title] - Study Notes

> Generated using Bloom's Taxonomy methodology for progressive learning

---

## 1. Remember (Key Facts)

### Definitions
- **Term 1**: Definition...
- **Term 2**: Definition...

### Key Points to Memorize
- Point 1
- Point 2

### Quick Reference
| Concept | Description |
|---------|-------------|
| ... | ... |

---

## 2. Understand (Concepts Explained)

### Main Ideas
[Explain core concepts in simple terms]

### Analogies
[Relate to familiar concepts]

### Visual Overview
[Text-based diagram or flowchart]

---

## 3. Apply (Practical Usage)

### Step-by-Step Guide
1. Step one...
2. Step two...

### Examples
**Example 1**: [Description]

[Code or demonstration if applicable]

code

### Practice Exercises
- [ ] Exercise 1: ...
- [ ] Exercise 2: ...

---

## 4. Analyze (Deeper Understanding)

### Breaking It Down
[Component analysis]

### Comparisons
| Aspect | Option A | Option B |
|--------|----------|----------|
| ... | ... | ... |

### Relationships
[How parts connect to each other]

---

## 5. Evaluate (Critical Thinking)

### Advantages
- Pro 1
- Pro 2

### Limitations
- Con 1
- Con 2

### Best Practices
- Practice 1
- Practice 2

### Common Mistakes
- Mistake 1: [What to avoid]
- Mistake 2: [What to avoid]

---

## 6. Create (Apply Your Knowledge)

### Mini Projects
1. **Project Name**: Description...

### Challenge Yourself
- Challenge 1: ...
- Challenge 2: ...

### Further Exploration
- Resource 1
- Resource 2

---

## Quick Review Checklist

- [ ] I can define the key terms
- [ ] I understand the main concepts
- [ ] I can apply this knowledge practically
- [ ] I can analyze and compare related concepts
- [ ] I can evaluate when to use this knowledge
- [ ] I can create something new using what I learned

---

*Notes generated on: [Date]*

Step 5: Save the Notes

  1. Determine the output filename:

    • If from reference file: [original-filename]-notes.md
    • If from topic: [topic-slug]-notes.md
  2. Save in the same directory as the reference file

    • If no reference file, save in current working directory
  3. Confirm the file location to the user

Examples

Example 1: Topic-Based Generation

User Input: "Generate notes on Python Lists"

Output: python-lists-notes.md containing:

  • Remember: List syntax, indexing, common methods
  • Understand: How lists store data, mutability explained
  • Apply: Creating lists, adding/removing items, iteration
  • Analyze: Lists vs tuples vs sets comparison
  • Evaluate: When to use lists, performance considerations
  • Create: Build a to-do list app, data processing exercise

Example 2: Reference File Generation

User Input: "Generate notes from ./chapter3-databases.pdf"

Output: chapter3-databases-notes.md saved in ./ containing structured notes extracted and organized according to Bloom's Taxonomy levels.

Best Practices

  1. Keep it beginner-friendly: Use simple language and avoid jargon
  2. Include practical examples: Real-world applications aid understanding
  3. Build progressively: Each level should build on the previous
  4. Make it actionable: Include exercises and challenges
  5. Use visual aids: Tables, lists, and text diagrams enhance clarity

Requirements

  • For reference files: File must be readable (text, markdown, PDF, code files)
  • Topic titles should be specific enough to generate meaningful content
  • Internet connection needed if WebSearch is required for additional context