textbook-writer-skills: Instructions file for Claude Code

CLAUDE.md

textbook-writer-skills CLAUDE.md is an instructions file for Claude Code, Codex from cabbage2000-lab/textbook-writer-skills. It costs 4,487 tokens per session, scanned A, original, MIT.

Project instructions for a repository of agent skills, meaning Markdown programs that guide AI models, for writing textbooks through backward design. It includes structure checks, unit tests, and real-session evaluations.

In plain words
What is it for?
Running repository validation and unit tests, locally trying skills, and evaluating textbook-writing workflows across science, humanities, and economics subjects.
Why use it?
It explains how to validate both the files and the actual behavior of these skills, since ordinary tests cannot fully judge model-generated writing.

Instructions file for Claude CodeCodex

Written for Claude Code and Codex: Claude Code plugin machinery, but also reads ~/.codex or $CODEX_HOME. Also seen: reads .claude/ paths; mentions CLAUDE.md; names the AskUserQuestion tool.

This is cabbage2000-lab/textbook-writer-skills's own configuration. It tells Claude Code and Codex how to work on textbook-writer-skills itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything textbook-writer-skills configures →

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is mkdir -p .claude && ln -s ../skills .claude/skills.

Reuse

Borrowing it

Nothing to install: this file belongs to cabbage2000-lab/textbook-writer-skills. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/cabbage2000-lab/textbook-writer-skills/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/cabbage2000-lab/textbook-writer-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for textbook-writer-skills CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/cabbage2000-lab/textbook-writer-skills/claude-md/github.svg)](https://agentmods.dev/instructions/cabbage2000-lab/textbook-writer-skills/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/cabbage2000-lab/textbook-writer-skills/claude-md"><img src="https://agentmods.dev/badge/instructions/cabbage2000-lab/textbook-writer-skills/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for textbook-writer-skills CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/cabbage2000-lab/textbook-writer-skills/claude-md"><img src="https://agentmods.dev/badge/instructions/cabbage2000-lab/textbook-writer-skills/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,487 This file is loaded in full into every session.
When invoked 4,487 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.04487 $0.04487
Opus 5 $0.02243 $0.02243
Sonnet 5 $0.00897 $0.00897
Haiku 4.5 $0.00449 $0.00449

Measured 5d ago against content hash 3c955c19531b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

textbook-writer-skills CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 117 lines

How it starts

The opening of the file, as written. The whole thing — 117 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

仓库性质

这是一个 agent skills/plugin 仓库(目标宿主:Claude Code / Codex / WorkBuddy):产品本身是 skills/ 下的 5 个 Markdown skill("给模型看的程序"),没有传统应用代码。改一行指令就可能改变 skill 的运行行为,而结构校验和单元测试只能保证文件形态正确,行为质量必须靠 evals 真实运行来检验——这是本仓库三层防线设计的出发点。Python 只出现在质量保障脚本中(零第三方依赖,3.10+ 标准库)。

领域:以 UbD 逆向设计为内核的教材写作流水线(学科无关内核 + 可插拔学科档案;内置 stemhumanitieseconomics 三份档案,humanities 的大纲与单章两条路径已由 eval 7、8 实跑验证,economics 的 eval 9、10 待跑)。设计依据源自 PRD 与前期调研(本地 docs/ 目录留存,不纳入版本库);版本库内可查的架构决策摘要见 docs/adr/

常用命令

python3 scripts/validate_skills.py       # ① 结构校验(skills 内容 + plugin 清单一致性 + 仓库健康)
python3 -m unittest discover -s tests    # ② 单元测试(校验逻辑本身)

# 单跑一个测试
python3 -m unittest tests.test_validate_skills.ValidateSkillsTest.test_valid_skill_passes

# 本地试跑 skill:软链为项目级 skills,改动即时生效(.claude/ 已 gitignore)
mkdir -p .claude && ln -s ../skills .claude/skills

③ 第三道防线是行为测试(evals),无法自动化:在新开的会话中(Claude Code 为基线宿主,跨宿主复跑口径见 evals/README.md)输入 evals/evals.json 用例的 prompt 原文真实运行,对照 assertions 逐条客观判定(通过/不通过 + 产物证据),任何一条不通过即用例不通过,不许改断言迁就产出。运行产物放 evals/workspace/(已 gitignore,用例定义入库、运行产物不入库)。

架构

1 个主 skill + 3 个子 skill + 1 个独立辅助 skill 构成整体组合(跨 skill 以 ../<skill-name>/references/xxx.md 相对路径互引,需整体安装,不得引入仓库外依赖):

textbook(orchestrator)  五阶段调度 + .progress.json 状态机(中断可续)
  ├─ textbook-outline     阶段 1–3:教学定位 → UbD 五件套(核心 gate) → 章节树+梯度(次要 gate)
  ├─ textbook-chapter     阶段 4:四段式单章写作(stem 档案:概念讲解→示范例题→引导练习→独立习题)
  └─ textbook-exercises   被单章 skill 调用:三类题生成 + 每题验证(手段取自学科档案)

textbook-init(独立辅助)  不入调度链:动笔前规划并创建工作目录(可选 git 与 README 工作说明),产出交接给 textbook

skills/textbook/references/handoff-contract.md 是全项目唯一权威定义——阶段间交接契约、教材项目落盘布局、.progress.json 状态机与重入规则、进度打印/gate 停点格式、上下文隔离原则,全部以它为准。5 个 SKILL.md 一律引用它,不得各自重复定义;契约字段名上下游逐字一致,同义改写(如"章节树"写成"章节列表")即破坏契约。

Read the full file on GitHub · 117 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago Changed · +8 lines · +955 tokens per session 3c955c19531b
  2. 9d ago First seen · 109 lines · 3,532 tokens per session scan A 138caf3a2378

Subscribe to this mod's changes

textbook-writer-skills CLAUDE.md is an instructions file published in the GitHub repository cabbage2000-lab/textbook-writer-skills (27 stars, last pushed 7d ago), licensed MIT. It adds 4,487 tokens to every session, about $0.0224 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 3,735 tokens