textbook-init SKILL.md skillA

textbook-init from cabbage2000-lab/textbook-writer-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cabbage2000-lab/textbook-writer-skills/textbook-init@v0.7.0

Pins v0.7.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cabbage2000-lab/textbook-writer-skills
Path
skills/textbook-init/SKILL.md
Versions recorded
6
Latest version
v0.7.0, committed Oct 19, 2026
First version recorded
Aug 3, 2026
Size
6,150 bytes
Repository stars
37
License
MIT

动笔写教材前要先规划并创建工作目录时用它:规划单本教材项目目录或多教材工作区,可选 git 版本管理与 README 工作说明,建好后把产出交接给 textbook。触发语如"初始化教材项目"、"创建教材工作目录"、"规划教材工作区"、"建一个写教材的目录"。只搭目录骨架,不创建流水线文件(.progress.json、00-教材设计.md、术语表.md)。写正文用 textbook(不经 init 它也会自建默认目录),续写已有项目直接用 textbook。需与 textbook 系列其余 skill 装在同一 skills 目录下。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# textbook-init

动笔前的工作目录规划师:一轮提问弄清作者要写一本还是多本、放在哪里、要不要版本管理,呈现目录方案等确认后创建目录骨架(可含 git 仓库与 README 工作说明),最后把作者交给 textbook 主流程开写。教材项目内部的文件构成以 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md)(下称"契约文档")第 3 节为唯一权威定义,本 skill 只引用不重复定义。

## 何时不触发

- 已有教材项目要续写(目录里有 `.progress.json`)——直接用 textbook,它会按状态文件定位续点;
- 作者直接开写、不关心目录规划——textbook 启动时自会询问一次并默认 `./<教材名>/`,无需先走本 skill;
- 整理与教材写作无关的目录——本 skill 只服务教材项目的开局。

## 与流水线的关系

本 skill 只独立触发:不被 textbook 调度,不进五阶段契约链,产出是"就绪的空工作目录 + 启动指引"。

**流水线文件一律不建不改**:`.progress.json`(主 skill 是唯一写者,这是项目红线)、`00-前言.md`(阶段 5 派生生成)、`00-教材设计.md`(textbook-outline 写入)、`NN-<章标题>.md`(逐章生成)、`98-参考答案.md`(逐章追加)、`99-表现性任务.md`(阶段 5 派生生成)、`术语表.md`(主 skill 追加维护)。动机:主 skill 的重入判定靠"这些文件存不存在、内容有没有"定位续点(契约文档第 4 节),预建空文件会让它把全新项目误判成半成品;空壳文件混进交付物也违背"交付即可用"的底线。本 skill 创建的只有目录本身、`.gitignore` 和 README 工作说明——均在契约之外。

## 工作流

### 第 1 步:一轮提问

用 AskUserQuestion **一轮**收集四项(触发语已说明的项不再问):

1. **教材名**:如《线性代数入门》——将成为项目目录名;
2. **规划范围**:a) 只写这一本  b) 未来还会写多本(追加:工作区名,默认"教材工作区");
3. **位置**:项目/工作区建在哪个目录下,默认当前目录 `./`;
4. **git 版本管理**:默认要(教材写作周期以周计,版本保护值回票价);作者明确不要则跳过。

若当前环境没有 AskUserQuestion 工具,降级为编号提问并等待文本回复:

```text
请回答以下问题(回复格式如 "1 线性代数入门 2b 教材工作区 3 ./ 4 要"):
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cabbage2000-lab/textbook-writer-skills/textbook-init@sha256:1cc4030f2f48ed64

The line at the top of this page pins the label v0.7.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_66u3iwhaakrzkrai.svg)](https://markdownregistry.com/a/art_66u3iwhaakrzkrai)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Aug 3, 2026 and Oct 19, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
v0.7.0 latest2026-10-19 4729f74 6,150 BA view · diff
v0.6.22026-09-02 7dc21ea 6,150 BA view · diff
v0.6.12026-09-02 f9bed5c 6,183 BA view · diff
v0.6.02026-09-02 e80715c 6,175 BA view · diff
git:20260814.00d66542026-08-14 00d6654 5,907 BA view · diff
git:20260803.07ad1822026-08-03 07ad182 5,822 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6150 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cabbage2000-lab/textbook-writer-skills · 37 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_66u3iwhaakrzkrai
GET https://markdownregistry.com/api/v1/resolve?ref=cabbage2000-lab/textbook-writer-skills/textbook-init
GET https://markdownregistry.com/api/v1/blob/1cc4030f2f48ed6484b56be5f2880fc38f6aaf5a64760060b5acd57b9863b3c0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from cabbage2000-lab/textbook-writer-skills

AGENTS.md AGENTS.md file
cabbage2000-lab/textbook-writer-skills · AGENTS.md
git:20260810.5a8a299 · audit A · 37 stars
CLAUDE.md CLAUDE.md file
cabbage2000-lab/textbook-writer-skills · CLAUDE.md
git:20260902.7dc21ea · audit A · 37 stars
textbook-chapter SKILL.md skill
cabbage2000-lab/textbook-writer-skills · skills/textbook-chapter/SKILL.md · 按大纲切片与 UbD 锚点写或修订一章教材正文时用它,可依据已有 Word 文档、笔记、讲义及章稿:固定四段式结构——概念讲解 → 示范例题 → 引导练习 →…
v0.7.0 · audit A · 37 stars
textbook-exercises SKILL.md skill
cabbage2000-lab/textbook-writer-skills · skills/textbook-exercises/SKILL.md · 生成带 Bloom 层级标注的成套习题时用它,可依据已有 Word 文档、教材、讲义或笔记出题:示范例题(完整解题过程)、引导练习(带提示)、独立习题(附参考答案)三类,答案按学科档案逐题验证。触发语如"根据这份讲义出题"、"给这一章生成例…
v0.7.0 · audit A · 37 stars
textbook-outline SKILL.md skill
cabbage2000-lab/textbook-writer-skills · skills/textbook-outline/SKILL.md · 教材项目要做教学设计时用它,也能根据已有 Word 文档、讲义或课程材料规划教材:产出教学定位、UbD 预期结果五件套、章节树与例题 Bloom 梯度规划,写入…
v0.7.0 · audit A · 37 stars
textbook SKILL.md skill
cabbage2000-lab/textbook-writer-skills · skills/textbook/SKILL.md · 写一整本多章节教材或成体系的课程讲义(含习题)时用它,也可基于已有 Word 文档、讲义素材规划整本教材或修订项目中的指定章:按 UbD 逆向设计调度五个阶段,进度落盘 .progress.json…
v0.7.0 · audit A · 37 stars

Every file in cabbage2000-lab/textbook-writer-skills

Browse by kind, by grade A, or by owner.