Claude, Cookbook Audit

This video explains how the cookbook-audit Claude skill uses SKILL.md, a style guide, and a validation script to check a notebook against the same rubric every time.

1:36 video2 min readWatch on YouTube

Does auditing a cookbook notebook mean Claude is exercising some general sense of editorial quality? No. This video walks through the cookbook-audit skill to show that it runs a written rubric against a notebook, the same way every time, rather than judging the notebook by feel.

What the skill folder contains

The cookbook-audit skill is a folder Claude reads before it works, not something it is trained on. It holds three files: SKILL.md, style_guide.md, and validate_notebook.py, together forming a roughly 12-kilobyte instruction set written in plain language with no hidden logic. Claude reads the file and then acts on it. As the video puts it, the file is the program.

Three steps, run in order

The instructions sit in a Steps section. Claude reads SKILL.md, executes each step in order, and returns a result, linearly, with no branching unless a step calls for it. The process the video walks through is: hand the skill a notebook, it reads the rubric, checks the notebook against that rubric, and returns a score. That's the same three steps every time, regardless of which notebook is handed in.

Same input, same output

The video demonstrates the consistency this produces: hand cookbook-audit the identical notebook twice, and it returns the identical rubric score both times. That is the payoff of the file being the actual program running the check, rather than a loose set of guidelines interpreted freshly each time.

What happens outside the rubric's scope

The reverse case matters just as much. Hand the skill a notebook with something outside the stated rubric, and it still runs the same steps, checking only what SKILL.md names. validate_notebook.py is the check for structure, rubric items, and scope, and all of it is caught the same way regardless of what else the notebook contains. Auditing a notebook this way is not Claude forming its own opinion of quality, it is SKILL.md's rubric being read, applied, and checked consistently against whatever notebook is handed over.

The prompt to try

The video's suggested prompt is to ask Claude to audit an Anthropic cookbook notebook against a rubric, to read the cookbook-audit skill first, and to walk through what it will do before doing it. The video emphasizes watching for that walk-through specifically, since explaining first is what surfaces which rubric items SKILL.md actually checks and where the stated scope stops, rather than only seeing the finished score at the end.

Key takeaways

  • The cookbook-audit skill is a folder with SKILL.md, style_guide.md, and validate_notebook.py, not a training process.
  • Claude reads the steps and executes them in order, then validate_notebook.py checks the result against a rubric.
  • The same notebook run through the skill twice returns the identical score both times.
  • A notebook with something outside the stated rubric is still checked only against what SKILL.md names, not judged more broadly.
  • Auditing this way is not Claude forming an independent opinion of quality; it is a fixed rubric applied consistently.

Who this is for

This is for anyone building or using a Claude skill meant to check work against a rubric, and for anyone wondering whether a Claude audit reflects genuine judgment or a fixed, repeatable check.

Chapters

  1. 0:00The naive framing: "judge my notebook"
  2. 0:08A skill is a folder Claude reads — not trained on it
  3. 0:25The anchor: three steps, a notebook through validate_notebook.py
  4. 0:41The anchor returns: same input twice, then the rubric's limit
  5. 1:04Carry-out
  6. 1:15Your turn
  7. 1:32Outro
Full transcript(auto-generated, with timestamps)

The naive framing: "judge my notebook"

[0:00]Someone wonders if Claude will judge their notebook by feel, but this skill runs a written rubric. It audits. It doesn't judge. So, how does that work? A

A skill is a folder Claude reads — not trained on it

[0:08]Skill is a folder Claude reads before it works, not something it's trained on. This one is cookbook audit skill.md style guide.md invalidate notebook. Pi holding a 12 kilobyte instruction set plain language no hidden logic. Claude reads the file then acts. The file is the program. Instructions sit in a step

The anchor: three steps, a notebook through validate_notebook.py

[0:26]Section. Read skill.md execute each step in order to return the result linear no branching unless a step says so. Watch the anchor. Hand the skill a notebook. It reads the rubric, checks the notebook against it, and returns a score. Same three steps every time. Same notebook

The anchor returns: same input twice, then the rubric's limit

[0:41]Same score every run. Hand cookbook audit the identical notebook twice and it returns the identical rubric score both times. That's the payoff of a file being the program, but the reverse holds too. Hand it a notebook with something outside the stated rubric and it still runs the same steps checking only what skill.md names validate notebook. Pi is the check. Write structure. Write rubric items. Write scope. All caught the same way. Auditing a cookbook notebook isn't

Carry-out

[1:05]Claude forming its own opinion of quality. It's skill. md a rubric Claude reads, applies, and checks the same way against whatever notebook you hand it. Your turn. Here's

Your turn

[1:15]The prompt. Read it with me. I want to audit an Anthropic cookbook notebook against a rubric. Read the cookbook audit skill and walk me through what you will do before you do it. Watch for that walk-through. Explaining first is what surfaces which rubric items skill.md actually checks and where the scope stops. Lay him in for bear.

Outro

[1:32]Claude cookbook audit lay him in for bear.

More from Claude for Education

Humanitarians AI Lyrical Literacy Project