Submit
All tutorialsTutorial

Issue & Contribution Guidelines

Thank you for your interest in contributing to Claude Cookbooks! This guide helps you understand what types of contributions we welcome and how to make them effectively.

Claude Code Knowledge Pack7/10/2026

Issue & Contribution Guidelines

Thank you for your interest in contributing to Claude Cookbooks! This guide helps you understand what types of contributions we welcome and how to make them effectively.

Before You Open an Issue

  1. Search existing issues - Your question or bug may already be reported
  2. Check the docs - Many questions are answered in Claude Documentation
  3. Review CONTRIBUTING.md - For development setup and contribution guidelines

Issue Types

Bug Reports

Use bug reports for:

  • Broken links or missing files
  • Code that doesn't execute properly
  • Incorrect or outdated information
  • Missing dependencies or setup issues

Good bug reports include:

  • Specific file/notebook affected
  • Steps to reproduce the issue
  • Expected vs actual behavior
  • Your environment (Python version, OS)

Cookbook Proposals

We welcome proposals for new cookbooks that demonstrate Claude's capabilities. Before proposing:

We're looking for:

  • Notebooks that showcase Claude API/SDK capabilities directly
  • Practical, real-world use cases
  • Clear educational value with problem-focused learning
  • Self-contained examples that users can run immediately

We generally don't accept:

  • Translations of external frameworks or projects into the SDK
  • Notebooks that primarily promote external tools or services
  • Content that duplicates existing official documentation
  • Proposals without concrete implementation plans

Strong proposals include:

  1. Problem statement - What problem does this solve for users?
  2. Claude capabilities - Which API/SDK features does this demonstrate?
  3. Learning objectives - What will users learn?
  4. Outline - High-level structure of the proposed notebook
  5. Differentiation - How is this different from existing cookbooks?

Questions & Help

For usage questions:

Community Projects & Resources

Want to share a project you've built with Claude? The best places to showcase your work are:

  • Discord: Share in the #share-your-project channel on our Discord
  • Reddit: Post to the r/ClaudeAI community

These communities are great for getting feedback, connecting with other developers, and showcasing your work.

Response Expectations

  • Bug reports: We aim to triage within a few days
  • Proposals: We review periodically; complex proposals may take longer
  • Questions: Consider Discord for faster community responses
  • PRs: See our PR review process in CONTRIBUTING.md

What Happens After You Submit

  1. Triage - We'll label and categorize your issue
  2. Discussion - We may ask clarifying questions
  3. Decision - For proposals, we'll indicate if it fits our roadmap
  4. Action - Accepted items get scheduled for work or PR review

Contributing Code

Ready to contribute? See CONTRIBUTING.md for:

  • Development setup instructions
  • Code quality standards
  • PR guidelines
  • Testing requirements

Getting Help

Code of Conduct

We expect all contributors to be respectful and constructive. Issues that are spam, off-topic, or violate community standards may be closed without response.

Thank you for helping improve Claude Cookbooks!