Teach Yourself Skill
Скилл для создания учебных курсов: от определения задачи и источников до проверки глав и публикации в Markdown и HTML.
- 125 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Пишет файлы курса в рабочую папку и запускает проверочный скрипт на Node.js.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/teach-yourself-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Пишет файлы курса в рабочую папку и запускает проверочный скрипт на Node.js.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Teach Yourself Skill ведет агента через создание курса как продукта с проверяемым результатом. Сначала агент записывает задачу курса, аудиторию и источники в файлы рабочей папки, затем составляет план глав, пишет их и собирает в Markdown и HTML. К скиллу приложены шесть типов основного текста главы, шаблоны разделов, критерии оценки курса и скрипт `scripts/validate-course.mjs`. Скрипт без зависимостей проверяет структуру папок, закрытие блоков кода, HTML и локальные ссылки. Длинный курс идет пачками по три-четыре главы: после каждой пачки текст проходит проверку языка, скрипт и оценку по критериям. В репозитории лежит готовый пример на девять глав про качественное ИИ-ревью кода.
Для кого. Авторам курсов и методистам, которые собирают учебные материалы вместе с агентом и хотят проверять главы по чек-листу.
Подходит, если
- Нужен курс для новичков по внутреннему инструменту, и вокруг него есть код и документация.
- Серия уроков разрастается, и главы пора проверять по единым критериям.
- Готовый курс надо переписать или расширить, не потеряв структуру.
- Перед публикацией хочется прогнать курс скриптом по ссылкам и HTML.
Не подходит, если
- Нужна одна короткая памятка, а не курс с планом и проверкой.
- Нет источников: скилл строит утверждения на материалах, которые вы дадите.
- Язык курса не китайский: инструкции и проверка языка написаны под китайский текст.
Пример запроса к агенту
Используй teach-yourself-skill и создай курс для новичков по нашему API: сначала план и список источников, потом первая глава.Ограничения
Для полного цикла нужен второй скилл, humanizer-zh: его кладут в ту же папку скиллов, что и этот. Без него доступны план и проверка скриптом, но проверку языка пропустить нельзя, если нужен весь контур. Инструкции и критерии написаны по-китайски и рассчитаны на китайские тексты. Скрипт проверки запускают через Node.js. Лицензия в репозитории не указана, поэтому условия повторного использования уточняйте у автора. Один курс на десятки глав занимает много обращений к модели.
Как отключить. Удалите папку `teach-yourself-skill` из каталога скиллов агента. Созданные курсы лежат отдельно и останутся на месте.
Частые вопросы
Как поставить Teach Yourself Skill для Codex?
Выполните `npx skills@latest add chokcoco/teach-yourself-skill --agent codex --global --yes`. В задаче потом вызывайте скилл по имени `$teach-yourself-skill`.
Зачем нужен humanizer-zh?
Он проверяет текст главы на канцелярит и машинные обороты. Скилл считает его обязательной зависимостью, а общего способа установить другой скилл автоматически нет, поэтому папки кладут рядом вручную.
Как проверить курс без модели?
Запустите `node scripts/validate-course.mjs examples/high-quality-ai-code-review` или путь к своему курсу. Скрипт не требует установки зависимостей.
Из каких этапов состоит работа?
Пять этапов: задача и источники, план, две образцовые главы, остальные главы пачками, проверка каждой главы.
Что лежит в папке скилла?
`SKILL.md` с рабочим процессом, `scripts/` с проверкой, `references/` с критериями, `templates/` с шаблонами глав и `examples/` с готовым курсом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл Claude Code собирает изометрический разбор системы: по карте едет объект, и каждая остановка запускает шаг симуляции.
Скилл по интерфейсным текстам: ошибки, кнопки, пустые состояния и формы по четырем стандартам с оценкой по чек-листу.
Набор из 25 скиллов для Codex и Claude Code: статьи, исследования, видео на Remotion, интерфейсы, GitHub и проверка перед выпуском
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Marketing & SEO Skills
Marketing & SEO Skills for AI Agents
Библиотека из сотен маркетинговых и SEO-скиллов для агента: контент, типы страниц, каналы, реклама и стратегии
Двадцать два скилла для маркетинга и инженерии: тексты, соцсети, Chrome-расширения, PromQL, исследования и проверка скиллов
Коротко о README
Репозиторий оформлен как папка скилла: `SKILL.md`, скрипты проверки, справочники, шаблоны глав и пример курса. Работа делится на этапы с контрольными точками, а правки текста отменяют предыдущие отчеты о проверке.
Бейдж для README
Исходный SKILL.md
--- name: teach-yourself-skill description: 面向不同年龄、基础、职业和学习目标，规划、生成、质检并迭代通用型课程或系列教程。用于从任务定义与可信资料出发，按环境准备、语言基础、框架应用、原理诊断、综合实践、开篇总结等正文类型动态选择写法与讲师风格，设计可长可短的章节体系，生成 Markdown、HTML、练习、项目和参考资料，并通过确定性脚本、课程评价量规、humanizer-zh、回归检查与人工审核形成质量闭环；也用于重构、扩写、审阅或发布已有课程。 --- # Teach Yourself Skill 把课程当作一个有来源、有验收标准、可持续迭代的教学产品。不要把它压缩成一组固定长度的短课，也不要把“生成完文件”视为完成。 ## 先读取约束 开始前完成以下动作： 1. 查找并遵守仓库根目录及目标课程目录中的 `AGENTS.md`。 2. 读取目标课程 workspace 中已有的 `MISSION.md`、`RESOURCES.md`、`COURSE-GENERATION-SPEC.md`、`COURSE-BLUEPRINT.md` 和 `NOTES.md`。 3. 读取目标目录已有的生成脚本、课程目录、样章、参考资料和质量报告。不要覆盖用户改动。 4. 生成或改写中文学生可见文本前，完整读取已安装的 [Humanizer-zh](https://github.com/op7418/Humanizer-zh) 的 `humanizer-zh/SKILL.md`，并执行本文的 Humanizer 闸门。安装约定见 [humanizer 依赖](references/humanizer-dependency.md)。 5. 进入第二阶段语义质检前，完整读取 references/course-rubric.md。不要只凭本文件中的摘要自行发明评分标准。 如果课程 workspace 尚不存在，先根据用户目标创建最小任务定义。信息不足但不影响方向时，记录假设并继续；受众、课程目标、交付格式或事实来源的缺失会显著改变产物时，先向用户确认。 ## 建立课程任务定义 先把模糊的“做一门课”改写成可验收的任务。至少记录： - 课程为什么存在，以及学习完成后要解决什么问题 - 核心受众与必要的次级受众 - 学习者的前置知识、语言、年龄或职业背景 - 预期学习成果，以及学习者如何证明自己会了 - 可投入时间、学习节奏和使用场景 - 内容范围、明确不讲的内容和风险边界 - 每个章节的有效字符数字数要求，默认值设定为 12000，允许用户在课程初始化时候修改该值 - 交付格式、运行环境、发布方式与无障碍要求 - 来源政策、时效要求和允许使用的工具 - 人工审核者、发布权限和停止条件 把课程任务定义写入或更新 `MISSION.md` 与 `COURSE-GENERATION-SPEC.md`。已有任务定义优先于通用规则；发现冲突时，不静默选择其中一份。 ## 采用可变粒度，而不是固定短课 根据学习目标和认知负荷决定课程与章节大小，不设置统一篇数、字数或时长。 - 只有一个窄目标、依赖很少时，生成精简教程或单章课程。 - 目标包含多个阶段性能力时，生成模块化课程，并显式标出先修关系。 - 主题需要完整理论、案例、实践和复盘时，允许章节较长；用清晰分段和导航控制阅读负担。 - 同一章出现多个可独立验收的学习成果，或学习者必须跨越明显的前置知识台阶时，拆章。 - 两章分别无法形成完整解释或有效练习时，合并。 - 不为追求“丰富”强行加入代码、图表、案例、术语框或练习；只保留能帮助达成学习成果的材料。 - 不以字数代替深度。深度由机制解释、边界、证据、迁移练习和常见错误共同体现。