antigravity-devkit 1.0.0

package/template/skills/english-education/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: english-education
+description: English education content generation - lessons, quizzes, curriculum
+---
+
+# English Education Skill
+
+> Generate educational content for English language learning.
+
+---
+
+## Content Types
+
+| Type | Description | Template |
+|------|-------------|----------|
+| Lesson Plan | Structured lesson | lesson-templates.md |
+| Quiz | Assessment questions | quiz-templates.md |
+| Vocabulary | Word lists with context | inline |
+| Grammar | Rule explanations | inline |
+
+---
+
+## Lesson Plan Structure
+
+```markdown
+# Lesson: [Title]
+
+## Overview
+- **Level:** [A1-C2 / Beginner-Advanced]
+- **Duration:** [minutes]
+- **Topic:** [theme]
+- **Objectives:** [what students will learn]
+
+## Warm-up (5 min)
+[Engaging activity]
+
+## Presentation (15 min)
+[New content introduction]
+
+## Practice (20 min)
+[Guided exercises]
+
+## Production (15 min)
+[Free practice / application]
+
+## Wrap-up (5 min)
+[Summary and homework]
+
+## Materials
+- [List of needed materials]
+```
+
+---
+
+## Quiz Structure
+
+```markdown
+# Quiz: [Title]
+
+## Metadata
+- **Level:** [A1-C2]
+- **Topics:** [covered topics]
+- **Time:** [minutes]
+
+## Questions
+
+### Multiple Choice
+1. [Question]
+   - a) [option]
+   - b) [option]
+   - c) [option] ✓
+   - d) [option]
+
+### Fill in the Blank
+2. She ___ (go) to school every day.
+   **Answer:** goes
+
+### Matching
+3. Match the words with definitions:
+   | Word | Definition |
+   |------|------------|
+   | 1. happy | a. feeling joy |
+```
+
+---
+
+## CEFR Levels
+
+| Level | Description |
+|-------|-------------|
+| A1 | Beginner |
+| A2 | Elementary |
+| B1 | Intermediate |
+| B2 | Upper Intermediate |
+| C1 | Advanced |
+| C2 | Proficient |
+
+---
+
+## Content Guidelines
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Age-appropriate language | Complex jargon |
+| Clear instructions | Ambiguous tasks |
+| Varied question types | Single format only |
+| Progressive difficulty | Random difficulty |
+| Cultural sensitivity | Offensive content |
+
+---
+
+## References
+
+- `references/lesson-templates.md` - Lesson plan templates
+- `references/quiz-templates.md` - Quiz templates
+- `scripts/curriculum_validator.py` - Content validation

package/template/skills/english-education/references/lesson-templates.md

@@ -0,0 +1,151 @@
+# Lesson Plan Templates
+
+## Template 1: Grammar Lesson
+
+```markdown
+# Grammar Lesson: [Tense/Structure]
+
+## Overview
+- **Level:** [CEFR Level]
+- **Duration:** 45 minutes
+- **Grammar Point:** [specific structure]
+- **Objectives:** Students will be able to [use X in Y context]
+
+## Warm-up (5 min)
+- Quick review of previous lesson
+- Elicit examples from students
+
+## Presentation (15 min)
+### Form
+[Structure explanation with examples]
+
+### Meaning
+[When/why we use this structure]
+
+### Pronunciation
+[Any pronunciation notes]
+
+## Practice (15 min)
+### Controlled Practice
+1. [Gap-fill exercise]
+2. [Transformation exercise]
+
+### Freer Practice
+1. [Communication activity]
+
+## Production (8 min)
+[Real-life application task]
+
+## Wrap-up (2 min)
+- Review key points
+- Assign homework
+```
+
+---
+
+## Template 2: Vocabulary Lesson
+
+```markdown
+# Vocabulary Lesson: [Topic]
+
+## Overview
+- **Level:** [CEFR Level]
+- **Duration:** 45 minutes
+- **Topic:** [vocabulary theme]
+- **Target Words:** 8-12 items
+
+## Warm-up (5 min)
+- Picture discussion
+- Brainstorm related words
+
+## Presentation (10 min)
+### New Vocabulary
+| Word | Definition | Example |
+|------|------------|---------|
+| [word] | [meaning] | [sentence] |
+
+## Practice (20 min)
+1. Matching exercise
+2. Gap-fill sentences
+3. Categorization activity
+
+## Production (8 min)
+- Create sentences using new words
+- Role-play using vocabulary
+
+## Review (2 min)
+- Quick vocab check
+- Preview next lesson
+```
+
+---
+
+## Template 3: Reading Lesson
+
+```markdown
+# Reading Lesson: [Title]
+
+## Overview
+- **Level:** [CEFR Level]
+- **Duration:** 50 minutes
+- **Text Type:** [article/story/etc.]
+- **Skills:** [skimming/scanning/inference]
+
+## Pre-reading (10 min)
+- Vocabulary pre-teach
+- Prediction from title/images
+- Background activation
+
+## While-reading (25 min)
+### First Read (Gist)
+- Skim for main idea
+- Check predictions
+
+### Second Read (Detail)
+- Comprehension questions
+- Vocabulary in context
+
+## Post-reading (12 min)
+- Discussion questions
+- Personal response
+- Extension activity
+
+## Wrap-up (3 min)
+- Summary
+- Homework assignment
+```
+
+---
+
+## Template 4: Speaking Lesson
+
+```markdown
+# Speaking Lesson: [Topic]
+
+## Overview
+- **Level:** [CEFR Level]
+- **Duration:** 45 minutes
+- **Function:** [asking for directions/giving opinions/etc.]
+- **Objectives:** [fluency/accuracy focus]
+
+## Lead-in (5 min)
+- Discussion question
+- Set context
+
+## Model Dialogue (10 min)
+- Listen to example
+- Identify key phrases
+- Practice pronunciation
+
+## Controlled Practice (10 min)
+- Substitution drills
+- Pair practice with prompts
+
+## Freer Practice (15 min)
+- Role-play activities
+- Information gap tasks
+
+## Feedback (5 min)
+- Error correction
+- Good language highlighted
+```

package/template/skills/english-education/references/quiz-templates.md

@@ -0,0 +1,177 @@
+# Quiz Templates
+
+## Template 1: Grammar Quiz
+
+```markdown
+# Grammar Quiz: [Topic]
+
+**Level:** [CEFR]  
+**Time:** 15 minutes  
+**Points:** 20 total
+
+---
+
+## Part A: Multiple Choice (5 points)
+
+1. She ___ to work every day.
+   - a) go
+   - b) goes ✓
+   - c) going
+   - d) gone
+
+2. They ___ watching TV when I arrived.
+   - a) are
+   - b) was
+   - c) were ✓
+   - d) be
+
+---
+
+## Part B: Fill in the Blank (5 points)
+
+Complete with the correct form.
+
+1. He ___ (play) tennis every weekend.
+   **Answer:** plays
+
+2. We ___ (not/see) that movie yet.
+   **Answer:** haven't seen
+
+---
+
+## Part C: Error Correction (5 points)
+
+Find and correct the error.
+
+1. She don't like coffee.
+   **Correction:** She doesn't like coffee.
+
+---
+
+## Part D: Sentence Transformation (5 points)
+
+Rewrite using the word given.
+
+1. It's not necessary to come early. (HAVE)
+   **Answer:** You don't have to come early.
+
+---
+
+## Answer Key
+[Include all answers with explanations]
+```
+
+---
+
+## Template 2: Vocabulary Quiz
+
+```markdown
+# Vocabulary Quiz: [Topic]
+
+**Level:** [CEFR]  
+**Time:** 10 minutes  
+**Points:** 15 total
+
+---
+
+## Part A: Matching (5 points)
+
+Match the words with their definitions.
+
+| Word | Definition |
+|------|------------|
+| 1. ambitious | a. wanting to succeed |
+| 2. reliable | b. can be trusted |
+
+---
+
+## Part B: Fill in the Blank (5 points)
+
+Choose the correct word.
+
+Word bank: *happy, sad, angry, excited, nervous*
+
+1. She felt ___ before her exam.
+   **Answer:** nervous
+
+---
+
+## Part C: Word Formation (5 points)
+
+Complete with the correct form.
+
+1. He is very ___ (success) in his career.
+   **Answer:** successful
+```
+
+---
+
+## Template 3: Reading Comprehension
+
+```markdown
+# Reading Quiz: [Title]
+
+**Level:** [CEFR]  
+**Time:** 20 minutes
+
+---
+
+## Text
+[Insert reading passage]
+
+---
+
+## Questions
+
+### True/False (4 points)
+1. [Statement] T / F
+2. [Statement] T / F
+
+### Multiple Choice (4 points)
+3. What is the main idea?
+   - a) [option]
+   - b) [option] ✓
+   - c) [option]
+
+### Short Answer (4 points)
+5. Why did [character] [action]?
+   **Answer:** [Expected response]
+
+### Vocabulary in Context (3 points)
+6. The word "X" in paragraph 2 means:
+   **Answer:** [definition]
+```
+
+---
+
+## Template 4: Listening Quiz
+
+```markdown
+# Listening Quiz: [Topic]
+
+**Level:** [CEFR]  
+**Time:** 15 minutes
+
+---
+
+## Instructions
+Listen to the audio twice. Answer the questions.
+
+---
+
+## Part A: Gist (2 points)
+1. What is the conversation about?
+
+## Part B: Detail (6 points)
+2. What time does [X]?
+3. How much does [Y] cost?
+4. Where is [Z] located?
+
+## Part C: Inference (2 points)
+5. How does the speaker feel about [topic]?
+
+---
+
+## Audio Script
+[Include transcript for teacher reference]
+```

package/template/skills/english-education/scripts/curriculum_validator.py

@@ -0,0 +1,175 @@
+#!/usr/bin/env python3
+"""
+Curriculum Validator - Validate English education content
+Checks lesson plans, quizzes, and curriculum materials.
+
+Usage:
+    python curriculum_validator.py <file_or_folder>
+"""
+
+import sys
+import re
+from pathlib import Path
+
+
+class CurriculumValidator:
+    """Validate English education content."""
+    
+    CEFR_LEVELS = ["A1", "A2", "B1", "B2", "C1", "C2"]
+    
+    REQUIRED_LESSON_SECTIONS = [
+        "Overview",
+        "Warm-up",
+        "Practice",
+        "Wrap-up"
+    ]
+    
+    REQUIRED_QUIZ_SECTIONS = [
+        "Level",
+        "Time",
+        "Questions"
+    ]
+    
+    def __init__(self):
+        self.errors = []
+        self.warnings = []
+    
+    def validate_file(self, file_path: Path) -> bool:
+        """Validate a single file."""
+        content = file_path.read_text(encoding="utf-8")
+        filename = file_path.name.lower()
+        
+        if "lesson" in filename:
+            return self.validate_lesson(content, file_path)
+        elif "quiz" in filename:
+            return self.validate_quiz(content, file_path)
+        else:
+            return self.validate_generic(content, file_path)
+    
+    def validate_lesson(self, content: str, file_path: Path) -> bool:
+        """Validate a lesson plan."""
+        valid = True
+        
+        # Check for required sections
+        for section in self.REQUIRED_LESSON_SECTIONS:
+            if section.lower() not in content.lower():
+                self.errors.append(f"{file_path}: Missing section '{section}'")
+                valid = False
+        
+        # Check for CEFR level
+        if not self._has_cefr_level(content):
+            self.warnings.append(f"{file_path}: No CEFR level specified")
+        
+        # Check for objectives
+        if "objective" not in content.lower():
+            self.warnings.append(f"{file_path}: No learning objectives found")
+        
+        # Check for duration
+        if not re.search(r"\d+\s*(min|minute|hour)", content, re.I):
+            self.warnings.append(f"{file_path}: No duration specified")
+        
+        return valid
+    
+    def validate_quiz(self, content: str, file_path: Path) -> bool:
+        """Validate a quiz."""
+        valid = True
+        
+        # Check for level
+        if not self._has_cefr_level(content):
+            self.errors.append(f"{file_path}: No CEFR level specified")
+            valid = False
+        
+        # Check for questions
+        if "question" not in content.lower() and "##" not in content:
+            self.errors.append(f"{file_path}: No questions found")
+            valid = False
+        
+        # Check for answer key
+        if "answer" not in content.lower():
+            self.warnings.append(f"{file_path}: No answer key found")
+        
+        # Check for point values
+        if not re.search(r"\d+\s*point", content, re.I):
+            self.warnings.append(f"{file_path}: No point values specified")
+        
+        return valid
+    
+    def validate_generic(self, content: str, file_path: Path) -> bool:
+        """Generic content validation."""
+        valid = True
+        
+        # Check minimum content length
+        if len(content) < 100:
+            self.warnings.append(f"{file_path}: Content seems too short")
+        
+        # Check for proper markdown structure
+        if "#" not in content:
+            self.warnings.append(f"{file_path}: No markdown headings found")
+        
+        return valid
+    
+    def _has_cefr_level(self, content: str) -> bool:
+        """Check if content has a CEFR level."""
+        for level in self.CEFR_LEVELS:
+            if level in content.upper():
+                return True
+        return False
+    
+    def validate_folder(self, folder_path: Path) -> bool:
+        """Validate all markdown files in a folder."""
+        valid = True
+        
+        for file_path in folder_path.glob("**/*.md"):
+            if not self.validate_file(file_path):
+                valid = False
+        
+        return valid
+    
+    def report(self):
+        """Print validation report."""
+        print("=" * 60)
+        print("CURRICULUM VALIDATION REPORT")
+        print("=" * 60)
+        
+        if self.errors:
+            print("\n❌ ERRORS:")
+            for error in self.errors:
+                print(f"  - {error}")
+        
+        if self.warnings:
+            print("\n⚠️  WARNINGS:")
+            for warning in self.warnings:
+                print(f"  - {warning}")
+        
+        if not self.errors and not self.warnings:
+            print("\n✅ All content validated successfully!")
+        
+        print("\n" + "-" * 60)
+        print(f"Errors: {len(self.errors)}")
+        print(f"Warnings: {len(self.warnings)}")
+        
+        return len(self.errors) == 0
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python curriculum_validator.py <file_or_folder>")
+        sys.exit(1)
+    
+    target = Path(sys.argv[1])
+    validator = CurriculumValidator()
+    
+    if target.is_file():
+        validator.validate_file(target)
+    elif target.is_dir():
+        validator.validate_folder(target)
+    else:
+        print(f"Error: {target} not found")
+        sys.exit(1)
+    
+    success = validator.report()
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()