k2f-syllabus — скилл для Claude Code: программа курса в K2F
Собирает учебный силлабус из черновика, списка тем или старой программы: результаты обучения, расписание, веса оценок и политики. Экспорт в PDF через движок K2F.
npx skills add suzheng/k2f --skill k2f-syllabus -a claude-codeЧто делает k2f-syllabus
Скилл работает в два шага. Сначала агент пишет content_and_design.md — блюпринт будущего документа: блок идентичности курса с контактами и датами, описание и 3–6 результатов обучения, расписание по неделям, разбивка оценок со весами до 100%, политики и материалы. Отдельно прописывается дизайн-намерение: иерархия, плотность, единый формат дат, палитра под печать.
На втором шаге по этому блюпринту создаётся файл .K2F. Агент правит смысловое дерево и запускает pack/verify, а вёрстку, шрифты и тему собирает движок K2F, без пиксельных координат. На выходе — обычно PDF.
Скилл построен поверх базового **k2f**, его нужно поставить заранее: npx skills add suzheng/k2f --skill k2f. Без ядра второй шаг не выполнить. Внутри заложены проверки на арифметику весов, на привязку результатов к оцениванию и на дубли контактов в разных разделах. Обязательный текст политик скилл вставляет дословно только если вы его дали, остальное помечает для проверки.
Какие задачи решает
- собрать программу курса с непротиворечивыми весами оценок
- разложить длинный список тем на 6–12 учебных блоков с логикой группировки
- перенести устаревшую программу в аккуратный PDF
- связать результаты обучения с заданиями и дедлайнами
- вынести политики и материалы курса в отдельный короткий раздел
Примеры запросов агенту
- Собери силлабус по этому описанию курса: 10 недель, два семинара в неделю, итоговый проект
- Обнови старую программу из
syllabus_2023.md: сократи темы до 8 блоков и пересчитай веса - Сделай расписание с дедлайнами на одной сетке и выгрузи в PDF
Как установить k2f-syllabus
1Через Skills CLI (Vercel)
npx skills add suzheng/k2f --skill k2f-syllabus -a claude-code2Вручную: положить файлы
~/.claude/skills/k2f-syllabus/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/k2f-syllabus/
1Через Skills CLI (Vercel)
npx skills add suzheng/k2f --skill k2f-syllabus -a codex2Вручную: положить файлы
.agents/skills/k2f-syllabus/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add suzheng/k2f --skill k2f-syllabus -a cursor2Вручную: положить файлы
.cursor/skills/k2f-syllabus/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install suzheng/k2f k2f-syllabus2Вручную: положить файлы
.github/skills/k2f-syllabus/SKILL.md1Через Skills CLI (Vercel)
npx skills add suzheng/k2f --skill k2f-syllabus -a gemini-cli2Командой платформы
gemini skills install https://github.com/suzheng/k2f --path skills/education/k2f-syllabusВручную: положить файлы
.devin/skills/k2f-syllabus/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add suzheng/k2f --skill k2f-syllabus -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о k2f-syllabus
Как установить k2f-syllabus в Claude Code?
Выполните npx skills add suzheng/k2f --skill k2f-syllabus -a claude-code, файл скилла появится в ~/.claude/skills/k2f-syllabus/SKILL.md. До этого поставьте ядро: npx skills add suzheng/k2f --skill k2f.
Зачем нужен k2f-syllabus?
Он собирает учебный силлабус по шаблону: результаты обучения, расписание, оценки и политики. Разметку и типографику берёт на себя движок K2F, поэтому агент занят содержимым.
С какими платформами работает скилл?
С Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode; для каждого способа установки своя команда.
Исходный текст
SKILL.md · Apache-2.0
--- name: k2f-syllabus description: Draft instructor-ready course syllabi with aligned outcomes, a scannable schedule spine, grading architecture, and policy layers from prompts, outlines, or legacy syllabi. Use when the user asks for a syllabus, course outline, curriculum map, or term schedule for a class they are teaching or redesigning. Create syllabi 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 while automatically handling layout, typography, and formatting complexity. --- # K2F Syllabus — AI-Native Aesthetic Design ## Purpose Teach agents to blueprint a **course syllabus** before layout: day-one essentials, scannable layering, and aligned outcomes, meetings, and grades—without policy dumps, orphaned readings, or schedules that hide assessment logic. ## Built on K2F This skill produces course syllabi 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* (sections, schedule rows, policy blocks)—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 - An instructor needs a new or revised syllabus (higher ed, professional continuing ed, or structured K–12 course overview). - The user supplies partial inputs: catalog description, week topics, textbook, or an old syllabus to modernize. - Not for supplementary reading-list generators, exam prediction from past tests, or lesson-level daily plans (use **k2f-lesson-plan**). ## Workflow ### Step 1. Generate the content_and_design.md One blueprint for **what** belongs in the syllabus and **how** it should read when printed or shared as PDF. Structure it so the schedule spine and shared facts are named once and referenced everywhere the k2f skill will map to sections. **Sub-steps** 1. **Route & clarify** — Infer discipline, term length, meeting pattern, and audience (intro undergrad through professional). Ask at most two high-leverage questions (e.g., mandated policy text vs. draft, credit hours); default term length when unspecified. 2. **Course identity** — One **identity block**: title, catalog code, instructor contact, term dates, room/platform, office hours, prerequisites—do not repeat elsewhere. 3. **Course story** — Brief description plus **3–6 learning outcomes** with verbs suited to audience. Infer missing outcomes from the description; mark `[inferred]`. Link each outcome to an assessment or major assignment. 4. **Schedule spine** — Week/unit rows: topic, in-class focus, readings, due dates. Compress long topic lists into **6–12 units** with stated grouping logic. Label topics with **applied domain** (course context, not generic keywords). Place high-stakes deadlines on the spine, not only in grading prose. 5. **Assessment & grading** — Categories, weights to 100%, short performance cues, outcome alignment. Late-work rules here only when they change grades. 6. **Policies & support** — Attendance, integrity, accommodations, tech, communication—brief and neutral unless the user supplies approved text (use verbatim). List materials, tools, safety/field notes, and help resources. 7. **Design intent** — For the engine, not coordinates: - **Tone**: credible welcome; grads assume fluency, intro defines terms once. - **Hierarchy**: title/term first; outcomes and schedule next; policies last. - **Density**: tight schedule rows; policies as bullets; no duplicate identity narrative. - **Consistency**: one date format and unit label scheme; parallel schedule columns. - **Palette**: print-safe; one accent for outcomes or schedule header; clear dates/weights. **Rules & constraints** - **Golden thread** — Outcomes → schedule → assignments → weights; cut units that do not serve outcomes unless labeled enrichment. - **Honest inference** — Tag inferred fields; never fabricate accreditation details or mandatory policy quotes. - **Arithmetic discipline** — Weights total 100%; workload fits credit level. - **User-owned policy** — Mandated language verbatim; otherwise generic drafts flagged for registrar review. **Common failure modes** - Policies before purpose → identity, story, outcomes, then schedule. - Too many vague outcomes → consolidate to assessable skills. - Readings only in an appendix → tie to schedule rows. - Grading labels with no spine assignment → rename or add rows. - Repeated contact info → identity block only. - Audience mismatch in jargon or load → recalibrate verbs and readings. **Quality checklist** - [ ] Identity block complete; contacts not duplicated. - [ ] 3–6 outcomes linked to assessment/spine; `[inferred]` tagged. - [ ] Full-term spine; major dates visible; 6–12 units if compressed. - [ ] Weights total 100% and match spine assignments. - [ ] Policies concise; materials and support listed. - [ ] Design intent covers tone, hierarchy, density, consistency, palette. ### Step 2. Use the content_and_design.md and k2f skill to generate a K2F file and export to an appropriate file format. Follow **k2f** skill to instantiate the syllabus from the blueprint, apply roles from design intent, verify, and export the shareable syllabus (typically PDF).
© suzheng · Apache-2.0 · suzheng/k2f