mcpField
Q
q-educator

q-educator

github.com/tyrealqOther10987 installsUpdated 5w ago
Repository

About q-educator

Q-Educator is an interview-driven skill for instructors designing graduate-level, projects-first courses. It guides the creation of course materials through staged review, with an emphasis on student judgment, transparent reasoning, and subject-specific analogies.

Key features

  1. 01Six-question instructor interview
  2. 02Lecture and demo outlines
  3. 03Follow-up email drafting
  4. 04Assignment and group feedback templates
  5. 05Instructor review between deliverables

Use cases

  1. 01Planning materials for project-centered graduate courses
  2. 02Drafting scaffolded assignments and group feedback
  3. 03Creating demos grounded in course subject matter

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tyrealq/q-skills --skill q-educator

After installing, type/q-educatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
assignment_example.md
assignment_template.md
demo_example.md
demo_template.md
email_example.md
email_guidelines.md
feedback_example.md
feedback_template.md
interview_protocol.md
key_phrases.md
lecture_example.md
lecture_template.md
teaching_philosophy.md

Details

From the project README

Q-Educator

Produce course materials for graduate-level, projects-first courses through an interview-driven process that prioritizes student judgment, transparent reasoning, and domain-specific analogies.

References

  • references/teaching_philosophy.md — six governing principles
  • references/interview_protocol.md — six-question interview sequence
  • references/lecture_template.md — lecture outline structure and design rules
  • references/demo_template.md — demo outline structure and design rules
  • references/email_guidelines.md — follow-up email style rules
  • references/assignment_template.md — scaffolded assignment prompt structure
  • references/feedback_template.md — per-group feedback structure and design rules
  • references/key_phrases.md — philosophy catchphrases for natural use in content
  • references/lecture_example.md — example lecture outline with domain-specific analogies
  • references/demo_example.md — example demo outline with pipeline walkthrough
  • references/email_example.md — example follow-up email in conversational style
  • references/assignment_example.md — example assignment prompt with full scaffold
  • references/feedback_example.md — example per-group feedback document

Core Principles

  • Projects-first: students learn by executing analytical workflows, not absorbing lectures
  • Judgment over polish: develop scholarly judgment, not polished AI output
  • Instructor as arbiter: exemplars and diagnostic feedback, not content transmission
  • Repeat-exposure transfer: same analytic logic across projects in different domains
  • Transparent reasoning: justify choices, acknowledge tradeoffs, document decisions
  • Domain-specific analogies: always from the course's subject area, never generic tech

Workflow

Step 1 (Interview): Conduct six-question interview per references/interview_protocol.md. Only begin content generation after the interview is complete.

Step 2 (Content Pipeline): Produce deliverables in this order, pausing for instructor review after each:

DeliverableTemplateExample
Lecture Outlinereferences/lecture_template.mdreferences/lecture_example.md
Demo Outlinereferences/demo_template.mdreferences/demo_example.md
Follow-Up Emailreferences/email_guidelines.mdreferences/email_example.md

Step 3 (Assessment, as needed):

DeliverableTemplateExample
Assignment Promptreferences/assignment_template.mdreferences/assignment_example.md
Per-Group Feedbackreferences/feedback_template.mdreferences/feedback_example.md

Scope

Include: Lecture outlines, demo outlines, follow-up emails, assignment prompts, per-group feedback for graduate-level projects-first courses.

Checklist

  • Interview completed before drafting (references/interview_protocol.md)
  • Teaching philosophy principles reflected in content (references/teaching_philosophy.md)
  • Domain-specific analogies used throughout (never generic tech metaphors)
  • Each deliverable reviewed by instructor before proceeding to next
  • Key phrases appear naturally where appropriate (references/key_phrases.md)
  • Deliverable follows its template structure and design rules

Comments

Markdown supported