curriculum-generator

---
name: curriculum-generator
description: Intelligent educational curriculum generation system with strict step enforcement and human escalation policies
metadata:
  openclaw:
    requires:
      bins: ["node"]
      env: []
      config: []
    version: "1.0.0"
    author: "Apni Pathshala"
---

## DEBUG MODE

When the user includes "debug mode" or "show searches" in their curriculum request:

**Enable verbose output:**
- Print every neo-ddg-search query before executing
- Print number of results returned
- Print first 2-3 URLs extracted
- Print resource assignment: "Assigning to {topic}: {url}"

**Example debug output:**
```
[DEBUG] Executing neo-ddg-search("Python basics tutorial for beginners")
[DEBUG] Search returned 10 results
[DEBUG] Extracting URLs...
[DEBUG] Found: https://www.youtube.com/watch?v=rfscVS0vtbw
[DEBUG] Found: https://www.freecodecamp.org/learn/scientific-computing-with-python/
[DEBUG] Assigning to "Python Basics": https://www.youtube.com/watch?v=rfscVS0vtbw
```


## Dependencies

### Required Skills
This skill requires the following other skills to be installed:

- **neo-ddg-search**: For web searching educational resources
  - Install: `clawhub install neobotjan2026/neo-ddg-search`
  - Verify: Check if neo-ddg-search skill exists in skills directory

### Dependency Verification

At the start of curriculum generation, verify neo-ddg-search is available:
```
IF neo-ddg-search skill NOT found:
   🚨 DEPENDENCY MISSING
   
   The curriculum generator requires the neo-ddg-search skill for finding educational resources.
   
   Please install it:
   clawhub install neobotjan2026/neo-ddg-search
   
   Then restart this process.
   
   ⚠️ GENERATION CANNOT PROCEED without search capability
   
   STOP
```

### Search Tool Health Check

Before starting resource research, perform a test search:
```
Test: neo-ddg-search("Python tutorial test")

IF successful:
   ✅ Search tool operational
   Proceeding with resource research...
   
IF failed:
   🚨 SEARCH TOOL ERROR
   
   neo-ddg-search is installed but not responding correctly.
   
   Error: {error_details}
   
   Please check:
   • neo-ddg-search skill is properly installed
   • Internet connection is available
   • No firewall blocking DuckDuckGo
   
   ⚠️ Cannot proceed with resource research
   
   ESCALATE
```

# Curriculum Generator Skill

## Purpose
This skill helps generate customized educational curricula for PODs (Points of Delivery) through a structured, step-enforced process with mandatory human escalation when needed.

## Core Capabilities
- Guided requirement gathering via structured questionnaire
- Research-based curriculum design or assessment
- Excel (.xlsx) output generation
- Local memory storage for continuous improvement
- Background task execution
- Strict human escalation policy enforcement

## Storage Locations
- **Memory**: `~/.openclaw/skills/curriculum-generator/memory/`
- **Outputs**: `~/.openclaw/skills/curriculum-generator/outputs/`
- **Templates**: `~/.openclaw/skills/curriculum-generator/templates/`

## Activation Triggers
This skill activates when the user:
- Says "create curriculum", "design curriculum", or "assess curriculum"
- Says "curriculum help" or "start curriculum process"
- Explicitly requests curriculum generation for a POD

## CRITICAL RULES (NON-NEGOTIABLE)

### Core Principle
You MUST ask a human whenever you are forced to guess, infer, or trade off risk.
If a wrong decision could affect students, teachers, or POD operations, escalation is MANDATORY.

### Hard-Stop Escalation Triggers
You MUST stop and escalate to human if ANY of these occur:

**A. Missing or Ambiguous Inputs**
- Target age/grade level is unclear
- Teacher availability or capability is unknown
- Daily lab hours are not specified
- Infrastructure reliability (computers/internet/electricity) is unclear
- Whether existing curriculum exists is not confirmed

**B. Teacher Capability Risk**
- Teachers cannot operate computers independently
- Teachers lack experience running labs
- Teachers cannot manage lab discipline or session flow

**C. Operational Infeasibility**
- Curriculum hours exceed available lab hours
- Sessions per week exceed teacher capacity
- Student-to-computer ratio is unsafe
- Infrastructure cannot support planned activities

**D. High-Risk Curriculum Changes**
- Removing major learning outcomes
- Changing curriculum duration significantly
- Shifting learning area (e.g., digital literacy → employment readiness)
- Introducing new tools/platforms not previously used

**E. Contradictory Stakeholder Signals**
- Teachers say curriculum is too hard, students say too easy
- POD leader priorities conflict with feasibility
- Feedback loops contradict assessment data

### Escalation Format (MANDATORY)
When escalating, use this EXACT format:
```
🚨 HUMAN INPUT REQUIRED

Reason: [specific trigger]
Impact if Unresolved: [clear consequence]
Options (if any):
1. [option 1]
2. [option 2]

Awaiting Decision From: [POD Leader / Curriculum Owner]
```

## PROCESS FLOW

### STEP 0: SCENARIO IDENTIFICATION (MANDATORY)
Before anything else, determine:
- **Scenario A**: Assessment of existing curriculum
- **Scenario B**: Design of new curriculum

If unclear, STOP and ask user to confirm. Do NOT proceed without classification.

---

### SCENARIO A: ASSESSING EXISTING CURRICULUM

#### STEP A1: Gather Basic Information
Collect ALL of the following using the structured form:

**Section 0: Request Metadata**
- Request ID (auto-generate using timestamp)
- Date of Request (auto-capture)
- Requested By (Name + Role)
- POD Name (REQUIRED)
- Scenario Type (must be selected)

⚠️ If Scenario Type not selected → HARD STOP

**Section 1: Target Audience Profile (MANDATORY)**
1. Primary Student Group:
   - Age range
   - Grade/Education level
2. Student Background (check all that apply):
   - First-time computer users
   - Basic exposure (mouse, keyboard)
   - Prior digital lab experience
   - Mixed levels
3. Language Comfort:
   - Medium of instruction
   - English proficiency (Low/Medium/High)
4. Special Constraints:
   - Learning disabilities
   - Attendance inconsistency
   - Social/economic limitations

⚠️ If age/grade missing → HARD STOP and escalate

**Section 2: POD & Infrastructure Details (MANDATORY)**
1. Lab Infrastructure:
   - Number of computers
   - Average students per session
   - Internet availability (Reliable/Unstable/None)
   - Power backup (Yes/No)
2. Daily Lab Usage:
   - Available hours per day
   - Days per week lab is operational
3. Existing Tools/Platforms:
   - Operating System
   - Software already installed
   - Internet restrictions

⚠️ If lab hours or computer count missing → HARD STOP and escalate

**Section 3: Teacher Capability & Availability (MANDATORY)**
1. Number of Teachers Assigned
2. Teacher Availability:
   - Days per week
   - Hours per day
3. Teacher Capability Assessment:
   - Can operate computers independently? (Yes/No)
   - Comfortable managing digital labs? (Yes/No)
   - Prior experience with similar programs? (Yes/No)
4. Training Requirement:
   - No training needed
   - Short training needed
   - Extensive training needed

⚠️ Any "No" in capability assessment → Potential escalation

#### STEP A2: Stakeholder Inputs (Structured Summary)
Simulate structured stakeholder inputs based on provided data:
- **POD Leader**: Effectiveness, challenges, change needs
- **Teachers**: Teaching experience, curriculum gaps, student progress
- **Students**: Difficulty level, engagement, relevance

Then perform Teacher Capability Assessment:
- Can teachers operate computers independently?
- Can they run the lab as per curriculum?
- Can they manage discipline, safety, and session flow?
- Identify training gaps (if any)

#### STEP A3: Curriculum Evaluation
Evaluate curriculum on these dimensions:
- Relevance to student needs
- Alignment with industry/digital literacy goals
- Flexibility for varied learning speeds
- Outcome clarity and measurability
- Technology integration quality

Then perform Operational Feasibility Check:
- Lab schedule feasibility
- Teacher sufficiency
- Infrastructure readiness (computers, internet, electricity)

#### STEP A4: Recommendations
- Clearly state whether modification is required or optional
- If required, propose specific, actionable changes
- Flag risks explicitly

End with:
**Status: Draft Assessment – Pending Human Review**

---

### SCENARIO B: DESIGNING A NEW CURRICULUM

#### STEP B1: Define Curriculum Foundation
Explicitly define:
- **Learning Areas**: Digital Literacy / Academic Empowerment / Skill Development / Employment Readiness
- **Target Audience**: Grade, background
- **Clear, measurable Learning Outcomes** (no vague outcomes allowed)

#### STEP B2: Develop Course Structure
Generate:
- Modules and sub-topics
- Weekly lesson breakdown
- Learning objective per lesson
- Program duration (e.g., 3 months / 6 months)
- Class frequency

**Lab Planning (Mandatory)**:
- Daily lab operating hours
- Sessions per week
- Max students per session

**END OF STEP B2 - MANDATORY ACTION BEFORE PROCEEDING:**
```
BEFORE moving to Step B3, execute this command sequence:

1. Review the curriculum structure you just created
2. Identify ALL topics that will appear in the final output
3. For EACH topic, RIGHT NOW, execute:
   
   neo-ddg-search("{topic} tutorial for beginners")
   
4. Extract the first valid educational URL from results
5. Store it in a resource_map dictionary:
   
   resource_map["{topic}"] = "https://..."

6. Verify resource_map has entries for ALL topics
7. Only then proceed to Step B3

Example:
Topic: "Python Lists"
Execute: neo-ddg-search("Python Lists tutorial for beginners")
Result: Found https://www.youtube.com/watch?v=W8KRzm-HUcc
Store: resource_map["Python Lists"] = "https://www.youtube.com/watch?v=W8KRzm-HUcc"

DO NOT SKIP THIS. DO NOT PROCEED WITHOUT COMPLETING THIS.
```
```

## **Step 5: Create a Simpler Test in Telegram**

Now test with very explicit instructions. In Telegram, 

... (truncated)