Skip to content

Conversation

@torosent
Copy link
Collaborator

@torosent torosent commented Jan 29, 2026

Purpose

  • Adds comprehensive Claude skill documentation for building durable workflows with Azure Durable Task Scheduler
  • Includes skills for four SDK variants:
    • Azure Durable Functions (.NET Isolated) - Serverless workflows with Azure Functions
    • Durable Task .NET SDK - Standalone .NET applications
    • Durable Task Java SDK - Java applications
    • Durable Task Python SDK - Python applications
  • Each skill includes:
    • Quick start guide with minimal setup examples
    • Pattern selection guide (function chaining, fan-out/fan-in, human interaction, etc.)
    • Critical determinism rules with WRONG vs CORRECT code examples
    • Connection and authentication configuration
    • Reference documentation for patterns and setup/deployment

Does this introduce a breaking change?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:

How to Test

  • Get the code
git clone https://github.com/Azure-Samples/Durable-Task-Scheduler.git
cd Durable-Task-Scheduler
git checkout torosent/add-skills
  • Test the skills by using them with Claude/Copilot:
    • The skills are located in .claude/skills/ directory
    • Each skill has a SKILL.md file and references/ folder with patterns.md and setup.md

What to Check

Verify that the following are valid

  • Skills are properly structured with frontmatter (name, description)
  • Code examples are syntactically correct for each language
  • Determinism rules are accurate and comprehensive
  • Setup/deployment instructions are complete for local emulator and Azure
  • Pattern implementations follow best practices

Other Information

This PR adds documentation to help Claude/Copilot generate correct Durable Task code. The skills cover:

  • 7,044 lines of documentation added across 12 files
  • Comprehensive coverage of orchestration determinism constraints
  • Working code examples for all major workflow patterns
  • Authentication options for local development and Azure deployment

- Created SKILL.md for Durable Task Python SDK, detailing usage, patterns, and orchestration structure.
- Added patterns.md with detailed implementation patterns for function chaining, fan-out/fan-in, human interaction, durable timers, and more.
- Introduced setup.md for local development and Azure provisioning, including Docker setup, environment configuration, and deployment options.
@torosent torosent changed the title Add Durable Task Python SDK documentation and setup instructions Add Skills to Durable Functions, Durable Task SDKs and DTS Jan 29, 2026
@torosent torosent changed the title Add Skills to Durable Functions, Durable Task SDKs and DTS Add Claude skills to Durable Functions, Durable Task SDKs and DTS Jan 29, 2026
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.

2 participants