Skip to content

Add author and notebook registry for cookbooks #237

Merged
PedramNavid merged 8 commits into
mainfrom
pdrm/prep-site
Nov 19, 2025
Merged

Add author and notebook registry for cookbooks #237
PedramNavid merged 8 commits into
mainfrom
pdrm/prep-site

Conversation

@PedramNavid

Copy link
Copy Markdown
Collaborator

This adds the author/notebook registry for cookbooks as well as a PR template and yaml specs.

@github-actions

Copy link
Copy Markdown

Model Check Results

No model references found in changed files

This PR adds author and notebook registry infrastructure files (schemas, templates, and YAML configs). None of the changed files contain Claude model references, so there are no model validation issues to report.

Changed Files Reviewed:

  • .github/authors_schema.json
  • .github/pull_request_template.md
  • .github/registry_schema.json
  • authors.yml
  • registry.yaml

Summary:

All changed files are metadata and configuration files with no Claude API model usage. The PR is clear from a model validation perspective.

@github-actions

github-actions Bot commented Oct 23, 2025

Copy link
Copy Markdown

Summary

Status Count
🔍 Total 227
✅ Successful 64
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 8
❓ Unknown 0
🚫 Errors 132
⛔ Unsupported 23

Errors per input

Errors in README.md

Errors in skills/CLAUDE.md

Errors in skills/README.md

Errors in temp_md/00_The_one_liner_research_agent.md

Errors in temp_md/01_skills_introduction.md

Errors in temp_md/01_The_chief_of_staff_agent.md

Errors in temp_md/02_skills_financial_applications.md

Errors in temp_md/02_The_observability_agent.md

Errors in temp_md/03_skills_custom_development.md

Errors in temp_md/claude_3_rag_agent.md

Errors in temp_md/extended_thinking.md

Errors in temp_md/extended_thinking_with_tool_use.md

Errors in temp_md/extracting_structured_json.md

Errors in temp_md/finetuning_on_bedrock.md

Errors in temp_md/getting_started_with_vision.md

Errors in temp_md/guide.md

Errors in temp_md/memory_cookbook.md

Errors in temp_md/pdf_upload_summarization.md

Errors in temp_md/prerecorded_audio.md

Errors in temp_md/rag_using_mongodb.md

Errors in temp_md/rag_using_pinecone.md

Errors in temp_md/tool_choice.md

Errors in temp_md/usage_cost_api.md

Errors in temp_md/using_citations.md

Errors in temp_md/using_llm_api.md

Errors in temp_md/wikipedia-search-cookbook.md

Comment thread registry.yaml Outdated
zealoushacker
zealoushacker previously approved these changes Oct 27, 2025
@github-actions

Copy link
Copy Markdown

Model Check Results ✅

I've reviewed the changed files in this pull request for Claude model usage.

Summary

No model references found in changed files - All clear! ✅

Changed Files Analyzed

  • .github/authors_schema.json
  • .github/registry_schema.json
  • .gitignore
  • authors.yml
  • registry.yaml

Findings

The changed files in this PR are schema definitions and configuration files that do not contain any Claude model references. These files define:

  • Author metadata schema
  • Registry schema for cookbook metadata
  • Git ignore patterns
  • Author mappings
  • Cookbook registry data

No action required - This PR does not introduce any model references that need validation.


Automated model check based on Claude Models documentation

@github-actions

Copy link
Copy Markdown

Model Usage Review - ✅ PASSED

I've reviewed all model references in this PR against the current public models list from the Claude documentation.

Summary

All model references are valid and use current public models
Using recommended alias format (e.g., claude-sonnet-4-5) for maintainability
No deprecated models found
No internal/non-public model names found

Model References Found

The PR uses the following valid model identifiers:

  1. claude-sonnet-4-5 - ✅ Current alias (recommended)

    • Used in: registry files, Claude SDK notebooks, skills notebooks, and misc notebooks
    • This is the recommended alias format for Claude Sonnet 4.5
  2. claude-haiku-4-5 - ✅ Current alias (recommended)

    • Used in: moderation filter notebook, web pages notebook
    • This is the recommended alias format for Claude Haiku 4.5
  3. claude-opus-4-1 - ✅ Current alias (recommended)

    • Used in: Chief of Staff notebook, LlamaIndex notebooks, building evals notebook
    • This is the recommended alias format for Claude Opus 4.1
  4. claude-sonnet-4-5-20250929 - ✅ Full model ID (also valid)

    • Used in: .env.example file
    • This is the full model ID which is also valid but the alias is preferred for easier updates
  5. anthropic.claude-haiku-4-5-20251001-v1:0:200k - ✅ AWS Bedrock format

    • Used in: Bedrock finetuning notebook
    • This is the correct AWS Bedrock model identifier for Claude Haiku 4.5

Best Practices Observed

Excellent use of model aliases: The PR consistently uses aliases ending in version numbers (e.g., claude-sonnet-4-5) rather than dated versions, making future model updates easier.

Consistent model selection: Appropriate model choices for different use cases:

  • Sonnet 4.5 for general-purpose and agent work
  • Opus 4.1 for complex planning tasks
  • Haiku 4.5 for fast, lightweight tasks

Environment variable pattern: Uses environment variables for model configuration (e.g., MODEL = os.getenv("ANTHROPIC_MODEL", "claude-sonnet-4-5")) which follows best practices.

Recommendation

No changes needed. This PR demonstrates excellent model usage practices by using current public model aliases consistently throughout the codebase.


Generated by /model-check slash command

Add JSON schemas and YAML configurations for managing cookbook metadata
and author information. This includes:

- authors_schema.json: Schema for mapping GitHub usernames to author details
- registry_schema.json: Schema for cookbook metadata with required fields
  (title, path, slug, category, github_url, authors, date)
- authors.yml: Initial author mappings with Anthropic and contributors
- registry.yaml: Comprehensive cookbook registry with 70+ entries across
  multiple categories (capabilities, patterns, tools, multimodal, etc.)
Comment thread authors.yaml
Comment thread .github/registry_schema.json Outdated
Comment thread registry.yaml Outdated
Update schema validation to require `categories` array instead of single `category` string.
Add `archived` boolean field for cookbook status tracking.

Add GitHub Actions workflow to verify author URLs on pull requests and pushes.
Normalize multi-line descriptions in registry entries.
Comment thread registry.yaml
Comment thread registry.yaml
- Create `.github/scripts/verify_authors.py` with additional checks
- Verify GitHub handles exist and are valid
- Check website and avatar URLs are accessible
- Validate all registry.yaml authors are defined in authors.yaml
- Update workflow to trigger on both authors.yaml and registry.yaml changes
- Fix GitHub handle in authors.yaml (john-vajda → jpvajda,
  richmond-alake → RichmondAlake)
- Standardize registry.yaml categories and fix typo
  (Aesthethics → Aesthetics)
…alidation

Add path existence verification to the registry validation script.
Add command-line interface to run specific validations.
Update registry.yaml paths to match actual directory structure.
Add schema validation to the verification script using jsonschema library.
Constrain registry categories to a predefined enum list.
Update CI workflow to install jsonschema dependency.
"type": "array",
"items": {
"type": "string",
"enum": [

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@elie there are the categories I came up with, let me know if you think there's others we should add!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's call it Multimodal instead of Images so that we can future proof.

Do you imagine "Tools" being tool use specific? Or more like "Capabilities"

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, updated.

Tools was really just the tools feature.
image

All the 'capabilities' notebooks I have under RAG & Retrieval currently, that seemed to be closer to what a user might search. I found it hard to think of anything that wouldn't fall under a 'capability' especially now that there's multiple selections possible.

image

@PedramNavid PedramNavid merged commit 5abf30e into main Nov 19, 2025
4 checks passed
@PedramNavid PedramNavid deleted the pdrm/prep-site branch November 19, 2025 21:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants