Temporal Skill for Claude Code

A Claude Code custom skill that turns Claude into a Temporal expert consultant. Given a requirement, it identifies relevant Temporal concepts, explains the underlying mechanisms, provides correct Go SDK code, and points to official examples.

What It Does

/temporal 我需要实现一个批量视频处理任务，支持进度查询和取消

Claude will respond with:

• Requirement Analysis — Maps your need to Temporal patterns
• Relevant Concepts — Each concept with mechanism/principle explanation
• Go SDK Implementation — Runnable code examples
• Official References — docs.temporal.io links + samples-go examples
• Pitfall Guide — Common mistakes and correct alternatives

Install

# Clone
git clone https://github.com/irying/temporal-skill.git

# Copy to Claude Code skills directory
mkdir -p ~/.claude/skills/temporal
cp temporal-skill/SKILL.md ~/.claude/skills/temporal/

# Done. Use /temporal in any Claude Code session.

Knowledge Coverage

Core Building Blocks

• Workflow — Determinism constraints, replay mechanism, SDK replacements
• Activity — Timeout types, retry policies, heartbeat mechanism
• Worker — Task Queue, concurrency config, sticky execution

Communication

• Signal — Async external events → Workflow
• Query — Sync read-only state inspection
• Update — Sync validated state modification with response

Orchestration Patterns

• Child Workflow — Independent history, parent close policy
• Continue-As-New — History limit management, state carry-over
• Selector — Deterministic fan-in, timeout racing, channel selection
• Session — Worker affinity for multi-step file processing

Reliability

• Retry Policy — Backoff, max attempts, non-retryable errors
• Heartbeat — Progress reporting, failure detection, progress recovery
• Cancellation — Graceful cleanup with disconnected context

Evolution

• Versioning — GetVersion patching, Worker Versioning, Workflow cutover
• SideEffect — Non-deterministic operations in deterministic Workflows

24 Official samples-go Examples Indexed

Mapped from use case to sample directory for quick reference.

Local Repo Scanning

When used in a project with Temporal code, the skill automatically scans for:

• Existing Workflow/Activity definitions
• Signal/Query/Update usage patterns
• Retry and timeout configurations

This lets Claude say: "Your project already uses a similar pattern in xxx.go."

Customization

Edit ~/.claude/skills/temporal/SKILL.md to:

• Add your team's Temporal conventions
• Include project-specific patterns
• Add internal documentation links

License

MIT