Skip to main content
plugin

deep-learning-book — Claude Code plugin: a companion to the Deep Learning textbook

The deep-learning-book plugin for Claude Code tracks changes across twenty chapters of the Deep Learning textbook since 2016.

MIT ★ 30,251 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add alirezarezvani/claude-skills
/plugin install deep-learning-book@claude-code-skills
Open on GitHub

What deep-learning-book does

Each of the twenty chapters gets its own file: what the chapter establishes, how to use it, and a section on what changed after 2016. A separate reference, references/book_to_2026_delta.md, lists five corrections that carry most of the weight and rates confidence per claim. Weight decay and L2 are not interchangeable under an adaptive optimizer, transformers displaced the recurrence in Chapter 10, diffusion grew out of score matching. The rule the file states: the conflict sits in the recommendation, not the analysis.

Four standard-library scripts turn the book into something you can run. reading_path_planner.py takes a goal, a background and weekly hours, then returns an ordered path with an hour budget — and refuses a goal the book does not cover. training_diagnostics.py walks Chapter 11's rules in priority order, so a NaN is never filed as overfitting. capacity_planner.py builds the regularization ladder and ranks “shrink the model” last. model_arithmetic.py returns parameters, FLOPs and activation memory per example, and rejects a stack whose shapes do not connect.

No text from the book appears here. It is copyrighted, so every chapter file is original synthesis with a link to the official free chapter. Python 3 is the only requirement: the tools load no frameworks, make no network calls, and support --help, --sample and --output json.

What it helps with

  • plan a reading route through the textbook for a specific goal and hour budget
  • tell overfitting apart from a NaN or another training failure
  • order the fixes when train and validation error diverge
  • compute parameters, FLOPs and activation memory for a layer stack
  • check which of the book's recommendations still hold and which were superseded

Example prompts for the agent

  • Plan a reading path: goal is training and debugging convnets, applied background, 5 hours per week
  • Run training diagnostics: train loss 0.02, val loss 1.9, fits a tiny subset
  • Compute parameters and memory from skills/deep-learning-book/assets/example_layer_spec.json

How to install deep-learning-book

Plugin marketplace

/plugin marketplace add alirezarezvani/claude-skills
/plugin install deep-learning-book@claude-code-skills

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about deep-learning-book

How do I install deep-learning-book in Claude Code?

Add the marketplace with /plugin marketplace add alirezarezvani/claude-skills, then install the plugin: /plugin install deep-learning-book@claude-code-skills.

What does deep-learning-book do?

It indexes the twenty chapters of the Deep Learning textbook, adds a post-2016 section to each, and ships four scripts for reading plans, training diagnostics, regularization choices and model arithmetic.

What do the scripts need to run?

Python 3 only. All four use the standard library, load no frameworks and make no network calls.

Source text

deep-learning-book · MIT
# deep-learning-book — study companion for *Deep Learning* (Goodfellow, Bengio & Courville)

A navigable, executable, **date-stamped** companion to the 2016 MIT Press textbook that is free
to read at [deeplearningbook.org](https://www.deeplearningbook.org/).

Twenty chapter files, a glossary, a patterns file, a cheatsheet, four references and four
deterministic tools — plus the thing a static compilation cannot give you: a **2016 → 2026 delta
layer** that says, per chapter, what still holds, what was superseded, and what is now purely
historical.

## Why this is a companion and not a compiled skill

This repository ships [`engineering/book-to-skill`](../book-to-skill/), which compiles a document
on disk into a knowledge-base skill. It was deliberately **not** used here, for three reasons its
own rights gate makes binding:

1. The book is copyrighted (MIT Press, 2016). Free to read ≠ free to redistribute.
2. deeplearningbook.org states that its HTML-only presentation is a deliberate friction against
   copying, required by the authors' contract, and that PDF distribution is not permitted.
3. This repository is public, and `book-to-skill`'s rights gate refuses a `shareable` package
   without `public-domain`, `open-license`, `internal-docs` or `author-permission`. None applies.
   (Its hard rule 1 also forbids scraping a book from the web, so the pipeline could not have run
   against a URL in any case.)

So this skill contains **no passages, paragraphs, figures, or per-paragraph paraphrase**. Every
chapter file is original synthesis — what the chapter establishes, how to use it, where it has
aged — with a link to the official free chapter. The organizing structure is the book's published
table of contents, which is factual metadata. Full reasoning in
[`references/rights_and_use.md`](skills/deep-learning-book/references/rights_and_use.md).

**The rule this sets for the repository:** when a user asks to convert a copyrighted work into a
shareable skill, build a companion that indexes and updates the source, not a compilation that
reproduces it. Compile only when the rights gate clears, and keep the output local when it does not.

## What is in it

```
skills/deep-learning-book/
├── SKILL.md              core frameworks + chapter index + topic index (~1.9k tokens, resident)
├── chapters/ch01..ch20   one file per chapter, each with "What changed after 2016"
├── glossary.md           every key term → its chapter
├── patterns.md           techniques as instruments, with trade-offs
├── cheatsheet.md         decision tables: loss choice, fit verdict, optimizer defaults
├── references/           delta layer · prerequisite map · study method · rights
├── scripts/              4 stdlib tools
└── assets/               layer spec · chapter worksheet · study log
```

## The tools

| Tool | Does | Refuses |
|---|---|---|
| `reading_path_planner.py` | Goal + background + hours → prerequisite-closed, ordered path with an hour budget | A goal outside the book (exit 3, names what covers it); an unroutable goal (exit 4, prints the questions) |
| `training_diagnostics.py` | Measurements → ranked cause + next action + chapter, rules in priority order | Diagnosing with no instruments (exit 4). Never reports a NaN as overfitting |
| `capacity_planner.py` | Gap + params-per-example → ordered regularization ladder | A validation error materially below training error (exit 4 — leaky split) |
| `model_arithmetic.py` | Layer stack → parameters, FLOPs, activation memory per example | A stack whose shapes do not connect (exit 5); an unknown layer type (exit 4) |

All four are standard-library only, support `--help` / `--sample` / `--output json`, make no
network calls, and load no frameworks.

## The delta layer

The book was published in 2016; *Attention Is All You Need* appeared in 2017. Five corrections
carry most of the weight, each cited and confidence-rated in
[`references/book_to_2026_delta.md`](skills/deep-learning-book/references/book_to_2026_delta.md):

1. **Double descent** qualifies Chapter 5's U-shaped capacity curve — "shrink the model when it
   overfits" is no longer the only correct move, and `capacity_planner.py` encodes the correction.
2. **AdamW**: weight decay and L2 are not equivalent under an adaptive optimizer; Chapter 7 treats
   them as interchangeable.
3. **Transformers** displaced Chapter 10's recurrence — keep its gradient-flow analysis, drop its
   architecture recommendation. (State-space models made that analysis live again.)
4. **Diffusion** grew directly out of Chapter 14's denoising autoencoders and Chapter 18's score
   matching, and displaced Chapter 20's model list.
5. **Self-supervised learning** vindicated Chapter 15's bet while replacing every method it names;
   unsupervised disentanglement was proven impossible without inductive bias.

The general rule the file states: the conflict is almost always in the **recommendation**, not the
**analysis**. Keep the diagnosis, replace the prescription.

## Use it

```bash
S=engineering/deep-learning-book/skills/deep-learning-book/scripts

python3 $S/reading_path_planner.py --goal "train and debug convnets" --background applied --hours-per-week 5
python3 $S/training_diagnostics.py --train-loss 0.02 --val-loss 1.9 --tiny-subset-fits yes
python3 $S/capacity_planner.py --params 12000000 --train-examples 50000 --train-error 0.01 --val-error 0.22
python3 $S/model_arithmetic.py --spec skills/deep-learning-book/assets/example_layer_spec.json
```

Slash commands: `/cs-deep-learning` (navigate and date the answer), `/cs-dl-reading-path`,
`/cs-dl-diagnose`. Agent: `cs-deep-learning-tutor`.

## Distinct from

- **`engineering/book-to-skill`** — the converter. This is what you build when its rights gate
  says no.
- **`engineering-team/senior-ml-engineer`** — production MLOps, deployment, serving. This is the
  theory underneath.
- **`engineering/llm-cost-optimizer`** — LLM economics, which the book predates entirely.
- **`teach` / `learn` skills** — general study workflows. This is one specific text, with its
  dependency graph and its expiry dates.

## Scope

The twenty chapters and the delta between them and 2026 practice. **Not covered**, because the
book does not cover them: reinforcement learning beyond passing mention, LLM training
infrastructure, RLHF/DPO, agentic systems, MLOps tooling, fairness and safety evaluation. The
skill is built to say so rather than improvise.

## Attribution

*Deep Learning*, Ian Goodfellow, Yoshua Bengio and Aaron Courville, MIT Press, 2016 —
https://www.deeplearningbook.org/. All rights in the book remain with its authors and publisher.
This companion is an independent work: no text, figures, or exercises from the book are
reproduced here, and it is not endorsed by or affiliated with the authors or MIT Press. The
companion's own content is MIT-licensed as part of this repository.

© Alireza Rezvani · MIT · alirezarezvani/claude-skills

Similar plugins

All plugins for AI and ML →

From the same set488

The whole set →
month-end-close month-end-close coordinates financial close calendars, balances reconciliations, and audits variance drivers. Runs Python stdlib scripts locally on CSV and JSON files. ★ 30,251repo stars coding-agent-rollout The coding-agent-rollout plugin audits Claude Code settings, MCP and plugin inventories, and CLAUDE.md layers. It also tracks a team’s rollout stage from local session counts. ★ 30,251repo stars agent-regression-evals agent-regression-evals compares agent runs before and after a change and decides whether the merge is safe. Useful when one trial can't separate a regression from noise. ★ 30,251repo stars loop-library loop-library guides you through designing, auditing, and finding repeatable AI agent loops with explicit guardrails and stop conditions. Helpful for managing Claude Code autonomy. ★ 30,251repo stars spinning-up-deep-rl spinning-up-deep-rl is a Claude Code plugin with study notes on deep reinforcement learning. It helps explain algorithms and debug RL code. ★ 30,251repo stars agent-memory A four-tier memory ladder for Claude Code that promotes facts through recurrence across days instead of model confidence. ★ 30,251repo stars agent-launcher-skills agent-launcher-skills is a Claude Code plugin that turns a session goal into an agent workflow, bounded grading loop, or recurring deployment. ★ 30,251repo stars human-gate human-gate is a Claude Code plugin that turns human feedback into a structured artifact and blocks task closure while blockers remain open. ★ 30,251repo stars

Project sponsors

Companies that keep this analytics open