How does the automated security check work?

The skill uses a validation script that runs detect-secrets with custom patterns to identify hardcoded credentials and compare them against a security baseline.

Can I use this for non-Anthropic notebooks?

While optimized for the Anthropic style guide, the workflow and automated checks are applicable to any Jupyter Notebook intended for technical education.

What does the Cookbook Audit skill check for?

It evaluates notebooks based on narrative flow, code quality, technical accuracy, actionability, and security issues like hardcoded API keys.

What is the scoring rubric used by this skill?

It applies a 20-point scale across four categories: Narrative Quality, Code Quality, Technical Accuracy, and Actionability/Understanding.

Cookbook Audit

Name: Cookbook Audit
Author: Activer007

byActiver007

0•

Learning & Documentation

Conducts comprehensive quality and security audits for technical notebooks based on established style guides and educational rubrics.

The Cookbook Audit skill provides a structured framework for reviewing and improving technical Jupyter Notebooks, specifically tailored for educational content like the Anthropic Cookbook. It guides users through an end-to-end workflow—from automated secret detection and style guide compliance to manual scoring of narrative quality and technical accuracy—ensuring every tutorial is actionable, secure, and pedagogically sound. By converting notebooks to markdown for easier review and providing prioritized improvement lists, it helps maintain high standards for developer documentation.

Key Features

010 GitHub stars

02Markdown conversion for streamlined, output-free manual reviews

03Structured audit report generation with prioritized recommendations

04Style guide alignment for Learning Objectives (TLOs/ELOs)

05Automated security scanning with built-in secret detection

06Rubric-based scoring for narrative, code, and technical accuracy

Use Cases

01Ensuring security best practices and credential hygiene in tutorials

02Standardizing educational content quality across different engineering teams

03Reviewing technical notebooks before publication to a developer portal

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills cookbook-audit

For use in Claude.ai and ChatGPT

Download Skill