Does it provide security checks for API keys?

Yes, it runs an automated validation script that uses detect-secrets to scan for hardcoded credentials and sensitive data within the notebook cells.

How is the audit report structured?

The report includes an Executive Summary with an overall score (X/20), detailed scoring across four dimensions, specific improvement recommendations, and concrete code examples.

What specifically does this skill audit in a notebook?

It checks for narrative quality, technical accuracy, code cleanliness (like using constants and dotenv), presence of learning objectives, and proper output management using a standardized rubric.

Why does it convert notebooks to Markdown?

Converting to Markdown removes noisy cell outputs and metadata, making it easier for Claude to focus on the narrative and code logic during the manual review phase.

Does it modify my notebook files directly?

No, it generates a markdown version in a temporary folder for review purposes and provides suggestions that you can apply manually to ensure full control over the content.

Cookbook Quality Auditor

Name: Cookbook Quality Auditor
Author: Microck

byMicrock

•

学習とドキュメンテーション

Audits Jupyter notebooks against professional documentation standards, technical best practices, and educational rubrics.

The Cookbook Audit skill provides a structured framework for reviewing and improving technical tutorials, specifically optimized for the Anthropic Cookbook style. It automates the validation of notebook structure, scanning for hardcoded secrets, and checking for adherence to the Diataxis framework for documentation. By evaluating everything from terminal learning objectives to code constant definitions, it helps authors transform raw code into polished, agency-building educational content with clear, actionable feedback.

主な機能

0181 GitHub stars

02Structural analysis of learning objectives (TLOs/ELOs)

03Markdown-based review workflow to reduce context noise

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

05Automated secret detection and dependency validation

06Standardized audit reporting with prioritized recommendations

ユースケース

01Pre-submission review for Anthropic Cookbook contributions

02Standardizing educational patterns across a team's notebook collection

03Internal auditing of technical tutorials and AI documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill