What framework does this skill use for auditing?

The skill is informed by the Diataxis framework, prioritizing a balance between action-oriented practical tasks and strategic technical understanding.

Can it review raw Jupyter notebooks directly?

Yes, the skill utilizes a validation script to convert .ipynb files into a markdown format in a temporary folder, making it easier for Claude to review the narrative and code without output clutter.

What metrics are used to score a cookbook?

Notebooks are scored on a scale of 0-20, with 5 points each allocated to Narrative Quality, Code Quality, Technical Accuracy, and Actionability & Understanding.

How does the cookbook-audit skill handle security?

The skill runs an automated detect-secrets scan using custom patterns to identify hardcoded API keys and credentials before the manual review process begins.

Cookbook Quality Auditor

Name: Cookbook Quality Auditor
Author: KimJiHan

byKimJiHan

0•

学习与文档

Automates the evaluation and auditing of technical Jupyter notebooks against standardized quality rubrics and security benchmarks.

The cookbook-audit skill provides a structured workflow for reviewing technical documentation and code samples, specifically optimized for the Anthropic Cookbook style guide. It streamlines the audit process by combining automated security checks—using secret detection to prevent credential leaks—with a guided manual review of narrative flow, code quality, and technical accuracy. By generating detailed markdown reports and scoring content across four key dimensions, this skill ensures that tutorials are not only functionally correct but also adhere to the Diataxis framework for educational excellence and developer agency.

主要功能

01Multi-dimensional scoring across Narrative, Code, Accuracy, and Actionability

02Style guide enforcement based on the Diataxis framework and Anthropic standards

030 GitHub stars

04Automated secret detection and API key scanning for Jupyter notebooks

05Automatic .ipynb to Markdown conversion for context-rich manual review

06Comprehensive audit report generation with prioritized improvement recommendations

使用场景

01Reviewing and scoring AI tutorial notebooks before public release

02Enforcing consistent documentation and code standards across a developer relations team

03Security auditing of technical notebooks for hardcoded credentials and deprecated API patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kimjihan/claude-cookbooks cookbook-audit

For use in Claude.ai and ChatGPT

Download Skill