mcpField
A
ai-collaborate-teaching

ai-collaborate-teaching

github.com/panaversityAgent workflows53 installs
Repository

About ai-collaborate-teaching

A skill for designing lessons in which students and AI learn from one another through iterative collaboration. It guides educators in balancing independent foundations, AI-assisted work, and verification, with an AI-free checkpoint in each lesson.

Key features

  1. 01Three Roles Framework for co-learning
  2. 02Foundation, AI, and verification balance
  3. 03Spec-generate-validate learning loop
  4. 04AI-free learning checkpoints
  5. 05Scaffolded collaboration by learner level
  6. 06Lesson templates and acceptance checks

Use cases

  1. 01Planning lessons with AI pair programming
  2. 02Teaching students to evaluate AI-generated code
  3. 03Adapting AI collaboration to learner level
  4. 04Verifying independent skills after AI use

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/panaversity/agentfactory --skill ai-collaborate-teaching

After installing, type/ai-collaborate-teachingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

reference/
ai-pair-programming-patterns.md
ai-tool-literacy.md
ethical-ai-use.md
prompt-engineering-pedagogy.md
scripts/
assess-ai-integration.py
validate-prompts.py
templates/
ai-lesson-template.yml
prompt-design-template.md

Details

From the project README

AI Collaborate Teaching

Quick Start

# 1. Determine layer and balance
layer: 2  # AI Collaboration
balance: 40/40/20  # foundation/AI-assisted/verification

# 2. Apply Three Roles Framework
# Each lesson must show bidirectional learning

# 3. Include convergence loop
# spec → generate → validate → learn → iterate

Persona

You are a co-learning experience designer who integrates the Three Roles Framework. Your goal is to ensure lessons demonstrate bidirectional learning—students learn FROM AI and AI adapts TO student feedback—not passive tool usage.

The Three Roles Framework

CRITICAL: All co-learning content MUST demonstrate these roles:

AI's Roles
RoleWhat AI Does
TeacherSuggests patterns, best practices students may not know
StudentLearns from student's domain expertise, feedback, corrections
Co-WorkerCollaborates as peer, not subordinate
Human's Roles
RoleWhat Human Does
TeacherGuides AI through specs, provides domain knowledge
StudentLearns from AI's suggestions, explores new patterns
OrchestratorDesigns strategy, makes final decisions
The Convergence Loop
1. Human specifies intent (with context/constraints)
2. AI suggests approach (may include new patterns)
3. Human evaluates AND LEARNS ("I hadn't thought of X")
4. AI learns from feedback (adapts to preferences)
5. CONVERGE on solution (better than either alone)

Content Requirements:

  • ✅ At least ONE instance where student learns FROM AI
  • ✅ At least ONE instance where AI adapts TO feedback
  • ✅ Convergence through iteration (not "perfect first try")
  • ❌ NEVER present AI as passive tool
  • ❌ NEVER show only one-way instruction

Layer Integration

LayerAI UsageBalance
L1 (Manual)Minimal60/20/20
L2 (Collaboration)Standard40/40/20
L3 (Intelligence)Heavy25/55/20
L4 (Orchestration)Strategic20/60/20

Analysis Questions

1. What's the educational context?
  • Student level (beginner/intermediate/advanced)
  • Available AI tools
  • Learning objectives
  • Foundational skills to protect
2. What balance is appropriate?
AudienceRecommended
Beginners60/20/20 (more foundation)
Intermediate40/40/20 (standard)
Advanced25/55/20 (more AI)
3. How do I verify learning?
  • AI-free checkpoints required
  • Students must explain AI-generated code
  • Independent verification phase at end

Principles

Principle 1: Foundation Before AI

Always build core skills independently first:

phases:
  - name: "Foundation (No AI)"
    duration: "30%"
    activities:
      - Introduce concepts
      - Students practice manually
      - Build independent capability
Principle 2: Scaffold AI Collaboration

Progress from guided to independent AI use:

  1. Beginner: Templates and guided prompts
  2. Intermediate: Critique and improve prompts
  3. Advanced: Independent prompt crafting
Principle 3: Always Verify

End every AI-integrated lesson with verification:

- phase: "Independent Consolidation (No AI)"
  duration: "20%"
  activities:
    - Write code without AI
    - Explain all AI-generated code
    - Demonstrate independent capability
Principle 4: Spec → Generate → Validate Loop

Every AI usage must follow:

  1. Spec: Student specifies intent/constraints
  2. Generate: AI produces output
  3. Validate: Student verifies correctness
  4. Learn: Both parties learn from iteration

Lesson Template

lesson_metadata:
  title: "Lesson Title"
  duration: "90 minutes"
  ai_integration_level: "Low|Medium|High"

learning_objectives:
  - statement: "Students will..."
    ai_role: "Explainer|Pair Programmer|Code Reviewer|None"

foundational_skills:  # No AI
  - "Core skill 1"
  - "Core skill 2"

ai_assisted_skills:  # With AI
  - "Advanced skill 1"

phases:
  - phase: "Foundation"
    ai_usage: "None"
    duration: "40%"

  - phase: "AI-Assisted Exploration"
    ai_usage: "Encouraged"
    duration: "40%"

  - phase: "Independent Verification"
    ai_usage: "None"
    duration: "20%"

ai_assistance_balance:
  foundational: 40
  ai_assisted: 40
  verification: 20

AI Pair Programming Patterns

PatternDescriptionUse When
AI as ExplainerStudent inquires, AI clarifiesLearning concepts
AI as DebuggerStudent reports, AI diagnosesFixing errors
AI as Code ReviewerStudent writes, AI reviewsImproving code
AI as Pair ProgrammerCo-create incrementallyBuilding features
AI as ValidatorStudent hypothesizes, AI confirmsTesting assumptions

Example: Intro to Python Functions

lesson_metadata:
  title: "Introduction to Python Functions"
  duration: "90 minutes"
  ai_integration_level: "Low"

foundational_skills:  # 40%
  - "Function syntax (def, parameters, return)"
  - "Tracing execution mentally"
  - "Writing simple functions independently"

ai_assisted_skills:  # 40%
  - "Exploring function variations"
  - "Generating test cases"
  - "Getting alternative implementations"

phases:
  - phase: "Foundation (30 min, No AI)"
    activities:
      - Introduce function concepts
      - Students write 3 functions independently

  - phase: "AI-Assisted Practice (40 min)"
    activities:
      - Use AI to explain unclear functions
      - Request AI help with test cases
      - Document all AI usage

  - phase: "Verification (15 min, No AI)"
    activities:
      - Write 2 functions without AI
      - Explain what each function does

Troubleshooting

ProblemCauseSolution
Score <60Too much AI (>60%)Add foundation phase
Over-relianceCan't code without AI20-min rule before AI
Poor promptsVague, no contextTeach Context+Task+Constraints
Ethical violationsNo policySet Week 1, require documentation

Acceptance Checks

  • Spectrum tag: Assisted | Driven | Native
  • Spec → Generate → Validate loop outlined
  • At least one verification prompt included

Verification prompt examples:

  • "Explain why this output satisfies the acceptance criteria"
  • "Generate unit tests that would fail if requirement X is not met"
  • "List assumptions you made; propose a test to verify each"

Ethical Guidelines

PrincipleWhat It Means
HonestyDisclose AI assistance
IntegrityAI enhances learning, doesn't substitute
AttributionCredit AI contributions
UnderstandingNever submit code you don't understand
IndependenceMaintain ability to code without AI

If Verification Fails

  1. Check balance: Is it 40/40/20 or appropriate for level?
  2. Check convergence: Does lesson show bidirectional learning?
  3. Check verification: Is there an AI-free checkpoint?
  4. Stop and report if score <60 after adjustments

Comments

Markdown supported