cookbook-audit

Audit Anthropic Cookbook notebooks against a rubric with automated checks.

Updated May 7, 2026
One-click install
npx skills add https://github.com/Observatoriodomos/DomosMirador --skill cookbook-audit-observatoriodomos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cookbook-audit
Source: https://github.com/Observatoriodomos/DomosMirador/tree/main/claude-cookbooks/.claude/skills/cookbook-audit
Command: npx skills add https://github.com/Observatoriodomos/DomosMirador --skill cookbook-audit-observatoriodomos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nbconvert, and includes scripts (resource) components.

What problem does it solve?

An Anthropic Cookbook notebook can drift from best practices over time, making it harder for readers to learn efficiently and safely reuse the material.

This skill audits a Cookbook notebook against a canonical style guide and rubric, surfaces critical issues, and provides targeted recommendations to improve clarity, structure, and technical correctness.

Core Features & Use Cases

  • Rubric-driven notebook auditing: Scores narrative quality, code quality, technical accuracy, and actionability using style_guide.md.
  • Automated technical checks: Runs python3 validate_notebook.py <path> to convert the notebook to review-friendly Markdown and perform validation checks.
  • Secret-safety verification: Detects potential hardcoded secrets via detect-secrets with project baselines and plugins, with fallback pattern scanning.

Quick Start

Use the cookbook-audit skill to audit an Anthropic Cookbook notebook at a local path by asking your agent to run the audit for: claude-cookbooks/notebooks/your-notebook.ipynb.

Frequently Asked Questions about cookbook-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a Jupyter notebook against a style guide and rubric?

To audit a Jupyter notebook against a style guide and rubric, you can use a validation script that converts the notebook to Markdown, checks for hardcoded secrets using detect-secrets, and generates a scored report with specific recommendations for narrative and code quality.

What does an automated notebook audit check for?

An automated notebook audit checks for critical issues and improvement opportunities by scoring narrative quality, code quality, technical accuracy, and actionability, while also verifying secret-safety through pattern scanning and baseline plugins.

How do I detect hardcoded secrets in an Anthropic Cookbook notebook?

To detect hardcoded secrets in an Anthropic Cookbook notebook, you run a validation script that utilizes detect-secrets with project baselines and plugins, providing a fallback pattern scan to ensure no sensitive information is exposed.

Can I use nbconvert to convert notebooks for code review?

Yes, you can use nbconvert to convert notebooks for code review. The audit process relies on nbconvert to transform the notebook into a review-friendly Markdown format before applying technical checks and rubric scoring.

What is the best way to improve technical accuracy in a notebook?

The best way to improve technical accuracy in a notebook is to audit it against a canonical rubric, which surfaces targeted recommendations and example-backed feedback to enhance structure, clarity, and correctness.

Do I need a style guide to review notebook code quality?

Yes, you need a style guide to review notebook code quality. The audit process requires reading a style guide first to establish the canonical standards used to score the notebook and generate actionable improvement recommendations.