How does the cookbook-audit skill handle Jupyter notebook files?

The skill utilizes a validation script to convert .ipynb files into markdown format. This process removes extraneous output noise and allows the AI to focus on the narrative structure and code logic.

What metrics are used to score a cookbook?

Notebooks are evaluated on a 20-point scale across four dimensions: Narrative Quality, Code Quality, Technical Accuracy, and Actionability/Understanding.

Can this skill detect leaked API keys in notebooks?

Yes, the skill runs automated checks using detect-secrets with custom patterns to identify and flag hardcoded API keys and other sensitive credentials before they are committed.

Does the audit follow a specific educational framework?

The audit is informed by the Diataxis framework and focuses on 'action + understanding,' ensuring notebooks provide both practical working code and transferable conceptual knowledge.

Cookbook Audit & Review

Name: Cookbook Audit & Review
Author: mbarnes-code

bymbarnes-code

학습 및 문서화

Audits and scores Anthropic Cookbook notebooks against standardized style guides and technical rubrics.

소개

This skill streamlines the review process for technical tutorials and cookbooks by enforcing specific style guidelines and best practices. It automates the detection of security risks like hardcoded credentials, converts complex Jupyter notebooks to clean markdown for easier evaluation, and provides a structured scoring system across narrative quality, code standards, and technical accuracy. It is an essential tool for developers and technical writers who need to ensure their educational content is high-quality, secure, and provides clear learning outcomes for users.

주요 기능

Structured report generation with prioritized, actionable recommendations
0 GitHub stars
Automated security scanning for API keys and hardcoded credentials
Notebook-to-Markdown conversion to facilitate cleaner context reviews
Standardized scoring rubric across four critical quality dimensions
Style guide enforcement for learning objectives (TLOs and ELOs)

사용 사례

Refining educational content to ensure code blocks are actionable and well-explained
Scanning technical tutorials for accidental credential leaks before public release
Reviewing community or internal notebook submissions for style consistency

소개

주요 기능

Structured report generation with prioritized, actionable recommendations
0 GitHub stars
Automated security scanning for API keys and hardcoded credentials
Notebook-to-Markdown conversion to facilitate cleaner context reviews
Standardized scoring rubric across four critical quality dimensions
Style guide enforcement for learning objectives (TLOs and ELOs)

사용 사례

Refining educational content to ensure code blocks are actionable and well-explained
Scanning technical tutorials for accidental credential leaks before public release
Reviewing community or internal notebook submissions for style consistency