suzheng/k2f

k2f-lesson-plan

Build classroom-ready lesson plans with standards-aligned arcs, student-facing materials, and observation look-fors from teacher notes or topic prompts.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/suzheng/k2f --skill k2f-lesson-plan

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

K2F Lesson Plan — AI-Native Aesthetic Design

Purpose

Teach agents to blueprint a teachable lesson before layout: anchored standards, a timed instructional arc, concrete student tasks, and synchronized teacher/student/observation artifacts—without generic filler, curriculum plagiarism, or documents that drift apart.

Built on K2F

This skill produces lesson packages as .K2F documents. Follow the k2f skill for authoring: unpack or init a workspace, edit the semantic tree, run pack/verify, then export. K2F keeps agents on meaning (phases, tasks, look-fors)—not pixel coordinates—while the engine compiles layout, typography, and theme.

Before you build, install the core skill: npx skills add suzheng/k2f --skill k2f.

When to Use

  • A teacher needs a new lesson (math, ELA, science, social studies, or adjacent K–12/higher-ed seminar formats).
  • The user wants a plan plus handouts, source excerpts, or an observation grid in one coherent packet.
  • Not for grading rubrics, quiz-only requests, or differentiating an existing plan without re-architecting content.

Workflow

Step 1. Generate the contentanddesign.md

One blueprint for what gets taught and how it should read and scan. Structure it so shared elements are named once and referenced everywhere the k2f skill will later map to pages.

Sub-steps

  1. Route & clarify — Infer subject, grade band, duration, and curriculum context from the prompt. Ask at most two high-leverage questions (e.g., standard to target, class constraints); default the rest. If subject pedagogy diverges (phenomenon-led science vs. inquiry social studies vs. problem-based math vs. text-centric ELA), note which arc applies.
  1. Standards anchor — State the performance target in teacher-usable form: standard code (if known) plus a ≤10-word gist. List prerequisites and key vocabulary the lesson assumes so the teacher can spot a class mismatch early. Flag likely misconceptions to address in facilitation—not as a lecture block, but in phase notes.
  1. Lesson-at-a-glance — Three sentences max: what students do, why it works for this class, and the measurable exit. Then a timed phase list (name, minutes, one line each) that sums to the block; every minute should tie to student action or formative check, not teacher monologue.
  1. Artifact map & shared registry — Declare which documents belong in the packet (minimum: teacher lesson plan; often: student materials, observation template; sometimes: source packet or printable manipulatives). Register once in a Shared content section anything that must match across pages: phenomenon/context, numbers/names in problems, vocabulary list, exit ticket, discussion prompts, look-fors. Cross-reference by stable keys in each artifact outline so edits cannot fork silently.
  1. Per-artifact outlines — Lesson plan: objective, materials, phase-by-phase facilitation (including questions and anticipated responses), differentiation hooks, closure. Student materials: only tasks students need on paper—workspace, stems, diagrams, sorting categories—at the lesson’s reading level. Observation template: narrow look-fors aligned to the objective (not a generic checklist). Oral-only lessons: state explicitly that no handout ships and what students use instead.
  1. Design intent — Capture aesthetic direction for the engine (not layout coordinates):
  • Tone: calm, print-friendly, professional teacher tool; student pages friendlier but not childish unless grade demands it.
  • Hierarchy: lesson title and objective highest contrast; phase names scannable; facilitation detail nested under phases, not flattened walls of prose.
  • Density: plan readable in prep time—bullets and numbered steps over paragraphs; student sheets leave intentional white workspace.
  • Consistency: one vocabulary for phases and tasks across all artifacts; section titles vs. in-block labels must not repeat the same words twice.
  • Palette: minimal color, high B&W print fidelity; one accent at most for phase labels or objective callout.

Rules & constraints

  • Original instructional writing — Curriculum or KG materials may inform scope and structure; never reproduce publisher student text, teacher scripts, or problem sets verbatim.
  • Golden thread — Standard → objective → phases → student work → exit ticket → look-fors; cut interesting tangents that do not advance the objective.
  • Time budget honesty — If activities cannot fit, narrow the objective or drop a phase; do not shrink student thinking time to zero.
  • Audience split — Teacher plan holds rationale and pivots; student materials hold only what learners see; observation holds evidence columns, not lesson script.

Common failure modes

  • Activities without a measurable exit → add or rewrite the exit ticket first, then align phases.
  • Phase list is all “explain” → insert pair-share, practice, or investigation with named student products.
  • Student handout duplicates the full plan → strip to tasks and graphics only.
  • Shared context changes in one artifact only → run a consistency sweep across every outline block.
  • Heading and block label repeat → move the task name to one location only.
  • Prerequisites omitted → teacher discovers mismatch on lesson day; surface assumed skills in the glance section.

Quality checklist

  • [ ] Standard anchor and objective match; exit ticket assesses the same skill.
  • [ ] Phases sum to allotted time; each phase has a student-visible action.
  • [ ] Shared registry lists every cross-document element with stable keys.
  • [ ] Student reading level fits grade; observation look-fors are observable in one period.
  • [ ] Design intent states tone, hierarchy, density, and print-safe palette.
  • [ ] No verbatim third-party curriculum text; sources paraphrased or excerpted with purpose noted.

Step 2. Use the contentanddesign.md and k2f skill to generate a K2F file and export to an appropriate file format.

Follow k2f skill to instantiate the packet from the blueprint, apply roles from design intent, verify, and export the classroom-ready deliverables.

Related by task

from this repository

More skills

All skills
suzheng
Community

k2f-event-poster

Turn event briefs into wall- or screen-ready posters with headline zone, hero visual intent, and scannable logistics—not programs, slide decks, or handout flyers. Use when the user asks for an event poster, concert poster, festival promo, exhibition poster, meetup banner, or large-format promo. Create event posters with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets them focus on semantic content and design intent

1h installs
19
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-cv

Compile a complete academic or senior professional curriculum vitae from notes, publication lists, and appointment history—with correct section order, honest bibliographic detail, and readable long-list hierarchy (not a one-page job resume). Use when the user asks for a CV, curriculum vitae, academic vita, faculty application CV, or multi-page career record. Create cvs with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2

1h installs
20
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-sales-deck

Turn discovery notes, proposals, and product proof into buyer-ready sales decks with a prospect-centered story, one objective per meeting, and evidence-backed slides. Use when the user asks for a sales deck, demo presentation, proposal deck, executive briefing, or sales slides (not a fundraising pitch deck or generic company overview). Create sales decks with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets them foc

1h installs
19
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-exam-paper

Design formal exam papers—midterms, finals, unit tests, or take-home assessments—from a syllabus, rubric, past papers, or source readings, with weighted coverage, unambiguous calls for response, and intentional answer space. Use when the user asks for an exam paper, test, quiz, final, midterm, or printable assessment to distribute to students. Create exam papers with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets

1h installs
8
GitHub stars
5
Updated
Nov 7