{"id":7605,"plugin_id":"Plugin_3e13d15b5ae4819196b61eb770c858e8","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:50:53.585Z","digest":"e9d2918872abf1b2615de16665ae7885e6e170001f048c765cc00a4881bf0da0","against":null,"payload":{"name":"temporal-developer","description":"Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET, Ruby, and Rust. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns. Also use when the user mentions \"run a Temporal workflow from the CLI\", \"start a dev server\", \"run temporal server start-dev\", \"temporal workflow start\", \"temporal workflow execute\", \"temporal workflow signal\", \"temporal workflow query\", \"temporal workflow update\".","included_files":[{"relative_path":"references/core/ai-patterns.md","size_in_bytes":5679},{"relative_path":"references/core/cli-workflow-commands.md","size_in_bytes":10060},{"relative_path":"references/core/determinism.md","size_in_bytes":6522},{"relative_path":"references/core/dev-management.md","size_in_bytes":4330},{"relative_path":"references/core/error-reference.md","size_in_bytes":3228},{"relative_path":"references/core/gotchas.md","size_in_bytes":9757},{"relative_path":"references/core/install_cli.md","size_in_bytes":1296},{"relative_path":"references/core/interactive-workflows.md","size_in_bytes":1380},{"relative_path":"references/core/patterns.md","size_in_bytes":15559},{"relative_path":"references/core/priority-fairness.md","size_in_bytes":10442},{"relative_path":"references/core/standalone-activities.md","size_in_bytes":8326},{"relative_path":"references/core/troubleshooting.md","size_in_bytes":9471},{"relative_path":"references/core/versioning.md","size_in_bytes":8985},{"relative_path":"references/dotnet/advanced-features.md","size_in_bytes":6771},{"relative_path":"references/dotnet/data-handling.md","size_in_bytes":5858},{"relative_path":"references/dotnet/determinism-protection.md","size_in_bytes":2733},{"relative_path":"references/dotnet/determinism.md","size_in_bytes":2647},{"relative_path":"references/dotnet/dotnet.md","size_in_bytes":8694},{"relative_path":"references/dotnet/error-handling.md","size_in_bytes":4613},{"relative_path":"references/dotnet/gotchas.md","size_in_bytes":7501},{"relative_path":"references/dotnet/observability.md","size_in_bytes":3159},{"relative_path":"references/dotnet/patterns.md","size_in_bytes":14242},{"relative_path":"references/dotnet/standalone-activities.md","size_in_bytes":6119},{"relative_path":"references/dotnet/testing.md","size_in_bytes":5885},{"relative_path":"references/dotnet/versioning.md","size_in_bytes":11749},{"relative_path":"references/go/advanced-features.md","size_in_bytes":6273},{"relative_path":"references/go/data-handling.md","size_in_bytes":7824},{"relative_path":"references/go/determinism-protection.md","size_in_bytes":3386},{"relative_path":"references/go/determinism.md","size_in_bytes":3073},{"relative_path":"references/go/error-handling.md","size_in_bytes":5724},{"relative_path":"references/go/external-storage.md","size_in_bytes":18486},{"relative_path":"references/go/go.md","size_in_bytes":8046},{"relative_path":"references/go/gotchas.md","size_in_bytes":7624},{"relative_path":"references/go/observability.md","size_in_bytes":5529},{"relative_path":"references/go/patterns.md","size_in_bytes":16081},{"relative_path":"references/go/standalone-activities.md","size_in_bytes":6667},{"relative_path":"references/go/testing.md","size_in_bytes":6604},{"relative_path":"references/go/versioning.md","size_in_bytes":9921},{"relative_path":"references/integrations.md","size_in_bytes":5242},{"relative_path":"references/java/advanced-features.md","size_in_bytes":6693},{"relative_path":"references/java/data-handling.md","size_in_bytes":9016},{"relative_path":"references/java/determinism-protection.md","size_in_bytes":3436},{"relative_path":"references/java/determinism.md","size_in_bytes":3488},{"relative_path":"references/java/error-handling.md","size_in_bytes":6286},{"relative_path":"references/java/gotchas.md","size_in_bytes":5580},{"relative_path":"references/java/integrations/spring-ai.md","size_in_bytes":13048},{"relative_path":"references/java/integrations/spring-boot.md","size_in_bytes":10213},{"relative_path":"references/java/java.md","size_in_bytes":10239},{"relative_path":"references/java/observability.md","size_in_bytes":4197},{"relative_path":"references/java/patterns.md","size_in_bytes":15096},{"relative_path":"references/java/standalone-activities.md","size_in_bytes":5470},{"relative_path":"references/java/testing.md","size_in_bytes":7947},{"relative_path":"references/java/versioning.md","size_in_bytes":11352},{"relative_path":"references/python/advanced-features.md","size_in_bytes":7165},{"relative_path":"references/python/ai-patterns.md","size_in_bytes":10518},{"relative_path":"references/python/data-handling.md","size_in_bytes":6312},{"relative_path":"references/python/determinism-protection.md","size_in_bytes":7056},{"relative_path":"references/python/determinism.md","size_in_bytes":2042},{"relative_path":"references/python/error-handling.md","size_in_bytes":4155},{"relative_path":"references/python/external-storage.md","size_in_bytes":15906},{"relative_path":"references/python/gotchas.md","size_in_bytes":7526},{"relative_path":"references/python/integrations/braintrust.md","size_in_bytes":7329},{"relative_path":"references/python/integrations/google-adk.md","size_in_bytes":10758},{"relative_path":"references/python/integrations/langgraph.md","size_in_bytes":8404},{"relative_path":"references/python/integrations/langsmith.md","size_in_bytes":9472},{"relative_path":"references/python/integrations/openai-agents-sdk.md","size_in_bytes":20630},{"relative_path":"references/python/integrations/opentelemetry.md","size_in_bytes":2738},{"relative_path":"references/python/integrations/pydantic-ai.md","size_in_bytes":11535},{"relative_path":"references/python/observability.md","size_in_bytes":3317},{"relative_path":"references/python/patterns.md","size_in_bytes":12341},{"relative_path":"references/python/python.md","size_in_bytes":8322},{"relative_path":"references/python/standalone-activities.md","size_in_bytes":5891},{"relative_path":"references/python/sync-vs-async.md","size_in_bytes":7285},{"relative_path":"references/python/testing.md","size_in_bytes":4996},{"relative_path":"references/python/versioning.md","size_in_bytes":12933},{"relative_path":"references/python/workflow-streams.md","size_in_bytes":21933},{"relative_path":"references/ruby/advanced-features.md","size_in_bytes":7983},{"relative_path":"references/ruby/data-handling.md","size_in_bytes":3978},{"relative_path":"references/ruby/determinism-protection.md","size_in_bytes":5254},{"relative_path":"references/ruby/determinism.md","size_in_bytes":2987},{"relative_path":"references/ruby/error-handling.md","size_in_bytes":2714},{"relative_path":"references/ruby/gotchas.md","size_in_bytes":7091},{"relative_path":"references/ruby/observability.md","size_in_bytes":2301},{"relative_path":"references/ruby/patterns.md","size_in_bytes":10441},{"relative_path":"references/ruby/ruby.md","size_in_bytes":6198},{"relative_path":"references/ruby/testing.md","size_in_bytes":6642},{"relative_path":"references/ruby/versioning.md","size_in_bytes":9047},{"relative_path":"references/rust/rust.md","size_in_bytes":7007},{"relative_path":"references/typescript/advanced-features.md","size_in_bytes":5730},{"relative_path":"references/typescript/data-handling.md","size_in_bytes":6074},{"relative_path":"references/typescript/determinism-protection.md","size_in_bytes":2412},{"relative_path":"references/typescript/determinism.md","size_in_bytes":2135},{"relative_path":"references/typescript/error-handling.md","size_in_bytes":3359},{"relative_path":"references/typescript/external-storage.md","size_in_bytes":12494},{"relative_path":"references/typescript/gotchas.md","size_in_bytes":9302},{"relative_path":"references/typescript/integrations/braintrust.md","size_in_bytes":3836},{"relative_path":"references/typescript/integrations/mastra.md","size_in_bytes":7684},{"relative_path":"references/typescript/integrations/opentelemetry.md","size_in_bytes":3691},{"relative_path":"references/typescript/integrations/vercel-ai-sdk.md","size_in_bytes":8619},{"relative_path":"references/typescript/observability.md","size_in_bytes":3821},{"relative_path":"references/typescript/patterns.md","size_in_bytes":11716},{"relative_path":"references/typescript/standalone-activities.md","size_in_bytes":5903},{"relative_path":"references/typescript/testing.md","size_in_bytes":6262},{"relative_path":"references/typescript/typescript.md","size_in_bytes":7751},{"relative_path":"references/typescript/versioning.md","size_in_bytes":9452}],"skill_md_contents":"---\nname: temporal-developer\ndescription: Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET, Ruby, and Rust. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns. Also use when the user mentions \"run a Temporal workflow from the CLI\", \"start a dev server\", \"run temporal server start-dev\", \"temporal workflow start\", \"temporal workflow execute\", \"temporal workflow signal\", \"temporal workflow query\", \"temporal workflow update\".\nversion: 0.6.2\n---\n\n# Skill: temporal-developer\n\n## Overview\n\nTemporal is a durable execution platform that makes workflows survive failures automatically. This skill provides guidance for building Temporal applications in Python, TypeScript, Go, Java, .NET, Ruby, and Rust.\n\n## Core Architecture\n\nThe **Temporal Cluster** is the central orchestration backend. It maintains three key subsystems: the **Event History** (a durable log of all workflow state), **Task Queues** (which route work to the right workers), and a **Visibility** store (for searching and listing workflows). There are three ways to run a Cluster:\n\n- **Temporal CLI dev server** — a local, single-process server started with `temporal server start-dev`. Suitable for development and testing only, not production.\n- **Self-hosted** — you deploy and manage the Temporal server and its dependencies (e.g., database) in your own infrastructure for production use.\n- **Temporal Cloud** — a fully managed production service operated by Temporal. No cluster infrastructure to manage.\n\n**Workers** are long-running processes that you run and manage. They poll Task Queues for work and execute your code. You might run a single Worker process on one machine during development, or run many Worker processes across a large fleet of machines in production. Each Worker hosts two types of code:\n\n- **Workflow Definitions** — durable, deterministic functions that orchestrate work. These must not have side effects.\n- **Activity Implementations** — non-deterministic operations (API calls, file I/O, etc.) that can fail and be retried.\n\nWorkers communicate with the Cluster via a poll/complete loop: they poll a Task Queue for tasks, execute the corresponding Workflow or Activity code, and report results back.\n\n## History Replay: Why Determinism Matters\n\nTemporal achieves durability through **history replay**:\n\n1. **Initial Execution** - Worker runs workflow, generates Commands, stored as Events in history\n2. **Recovery** - On restart/failure, Worker re-executes workflow from beginning\n3. **Matching** - SDK compares generated Commands against stored Events\n4. **Restoration** - Uses stored Activity results instead of re-executing\n\n**If Commands don't match Events = Non-determinism Error = Workflow blocked**\n\n| Workflow Code | Command | Event |\n|--------------|---------|-------|\n| Execute activity | `ScheduleActivityTask` | `ActivityTaskScheduled` |\n| Sleep/timer | `StartTimer` | `TimerStarted` |\n| Child workflow | `StartChildWorkflowExecution` | `ChildWorkflowExecutionStarted` |\n\nSee `references/core/determinism.md` for detailed explanation.\n\n## Getting Started\n\n### Ensure Temporal CLI is installed\n\nCheck if `temporal` CLI is installed. If not, follow the instructions at `references/core/install_cli.md` to install it for your platform.\n\n### Read All Relevant References\n\n1. First, read the getting started guide for the language you are working in:\n   - Python -> read `references/python/python.md`\n   - TypeScript -> read `references/typescript/typescript.md`\n   - Go -> read `references/go/go.md`\n   - Java -> read `references/java/java.md`\n   - .NET (C#) -> read `references/dotnet/dotnet.md`\n   - Ruby -> read `references/ruby/ruby.md`\n   - Rust -> read `references/rust/rust.md` (in Public Preview)\n2. Second, read appropriate `core` and language-specific references for the task at hand.\n\n## Primary References\n\n- **`references/core/determinism.md`** - Why determinism matters, replay mechanics, basic concepts of activities\n  - Language-specific info at `references/{your_language}/determinism.md`\n- **`references/core/patterns.md`** - Conceptual patterns (signals, queries, saga)\n  - Language-specific info at `references/{your_language}/patterns.md`\n- **`references/core/gotchas.md`** - Anti-patterns and common mistakes\n  - Language-specific info at `references/{your_language}/gotchas.md`\n- **`references/core/versioning.md`** - Versioning strategies and concepts - how to safely change workflow code while workflows are running\n  - Language-specific info at `references/{your_language}/versioning.md`\n- **`references/core/standalone-activities.md`** - Standalone Activities: run an Activity directly from a Client without a Workflow (Public Preview)\n  - Language-specific info at `references/{your_language}/standalone-activities.md`\n- **`references/core/troubleshooting.md`** - Decision trees, recovery procedures\n- **`references/core/error-reference.md`** - Common error types, workflow status reference\n- **`references/core/interactive-workflows.md`** - Testing signals, updates, queries\n- **`references/core/dev-management.md`** - Dev cycle & management of server and workers\n- **`references/core/cli-workflow-commands.md`** - Developer-facing CLI commands for workflow interaction (start, execute, signal, query, update)\n- **`references/core/ai-patterns.md`** - AI/LLM pattern concepts\n  - Language-specific info at `references/{your_language}/ai-patterns.md`, if available. Currently Python only.\n\n## Task Queue Priority and Fairness\n\nIf the developer is building a **multi-tenant application**, proactively recommend Task Queue Fairness. Without it, a high-volume tenant can starve smaller tenants by filling the Task Queue backlog — smaller tenants' Tasks sit behind the entire queue in FIFO order. Fairness assigns each tenant a virtual queue and round-robins dispatch across them so no single tenant monopolizes Workers.\n\nPriority and Fairness also apply to tiered workloads (batch vs. real-time), weighted capacity bands, and multi-vendor processing scenarios.\n\n- **`references/core/priority-fairness.md`** - Priority keys, fairness keys and weights, rate limiting, SDK examples, and limitations\n\n## Additional Topics\n\n- **`references/{your_language}/observability.md`** - See for language-specific implementation guidance on observability in Temporal\n- **`references/{your_language}/advanced-features.md`** - See for language-specific guidance on advanced Temporal features and language-specific features\n\n## Third-Party Integrations\n\nFor Temporal plugins and integrations with third-party frameworks and SDKs (Spring Boot, Spring AI, OpenAI Agents SDK, Google ADK, etc.), see **`references/integrations.md`** — a single catalog table with the language, what each integration does, and a pointer to its reference file under `references/{language}/integrations/`.\n\n## Feedback\n\n### Reporting Issues in This Skill\n\nIf you (the AI) find this skill's explanations are unclear, misleading, or missing important information—or if Temporal concepts are proving unexpectedly difficult to work with—draft a GitHub issue body describing the problem encountered and what would have helped, then ask the user to file it at https://github.com/temporalio/skill-temporal-developer/issues/new. Do not file the issue autonomously.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}