Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion plugins/temporal/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "temporal",
"version": "0.4.1",
"version": "0.4.2",
"description": "Comprehensive skill for the entire Temporal lifecycle — developing applications, using the Temporal CLI, running and managing Temporal Server, and working with Temporal Cloud.",
"author": {
"name": "Temporal",
Expand Down
12 changes: 3 additions & 9 deletions plugins/temporal/skills/temporal-cloud-setup/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,7 @@
---
name: temporal-cloud-setup
description: Set up Temporal Cloud and run a sample Workflow on it for the user, doing
the work end to end. Use when the user wants to set up Temporal Cloud, get started
on Temporal Cloud, install the unified Temporal CLI (prerelease cloud-cli), create
a Cloud namespace or API key, clone a money-transfer sample app, write the client
config TOML, or connect a local Worker to Temporal Cloud and run a sample Workflow.
This is the Cloud setup path, not the local learning path (see temporal-getting-started).
Covers Python, TypeScript, Go, Java, .NET, and Ruby SDKs.
version: 0.8.2
description: Set up Temporal Cloud and run a sample Workflow on it for the user, doing the work end to end. Use when the user wants to set up Temporal Cloud, get started on Temporal Cloud, install the unified Temporal CLI (prerelease cloud-cli), create a Cloud namespace or API key, clone a money-transfer sample app, write the client config TOML, or connect a local Worker to Temporal Cloud and run a sample Workflow. This is the Cloud setup path, not the local learning path (see temporal-getting-started). Covers Python, TypeScript, Go, Java, .NET, and Ruby SDKs.
version: 0.8.3
disable-model-invocation: true
---

Expand Down Expand Up @@ -802,4 +796,4 @@ On `status=error`, map the `error_code` via **`references/failure-handling.md`**
- `scripts/provision.sh` — **the deterministic executor.** Owns preflight / **detect-tools** / **preview** / install / login / regions / namespace-create / **install-deps (manager-parameterized)** / key-mint+config-write / verify / await-auth / **run-workflow (Worker + starter)** / clone / repair-config / cleanup-info. Invoke it and parse its `=== RESULT ===` block (see "Execution model" above); it is the single source of truth for the pinned CLI flags, the per-SDK run commands, **and the per-(SDK,manager) install matrix + minimum-version table**. Pure bash, portable across Claude Code, Codex, and Cursor. **Read-only during a run — invoke it, never edit it (read-only script).**
- `references/unified-cli.md` — background on the prerelease CLI and the client-config TOML: `login`/`whoami`, `region list`, `namespace create`, `apikey create-for-me`, file locations, and the auth-override gotcha. The script encodes these; read the reference when a flag drifts and you need to update the script.
- `references/sdk-cloud.md` — per-SDK table: repo + cloud branch, task-queue name, how each connects (`cloud-setup` profile), and worker/starter run commands. No connection edits — the branch is pre-wired.
- `references/failure-handling.md` — the `error_code` → remediation map. Read it **only when a subcommand returns `status=error`** (progressive disclosure — the happy path never opens it); the Failure Handling section above is a one-line pointer to it, and the Steps spine's On-error column is the index.
- `references/failure-handling.md` — the `error_code` → remediation map. Read it **only when a subcommand returns `status=error`** (progressive disclosure — the happy path never opens it); the Failure Handling section above is a one-line pointer to it, and the Steps spine's On-error column is the index.
14 changes: 3 additions & 11 deletions plugins/temporal/skills/temporal-developer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,7 @@
---
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".
version: 0.6.1
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".
version: 0.6.2
---

# Skill: temporal-developer
Expand Down Expand Up @@ -111,4 +103,4 @@ For Temporal plugins and integrations with third-party frameworks and SDKs (Spri

### Reporting Issues in This Skill

If 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.
If 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.
15 changes: 4 additions & 11 deletions plugins/temporal/skills/temporal-ops/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,8 @@
---
name: temporal-ops
description: 'Administer and diagnose running Temporal Cloud or self-hosted Temporal
Server environments via CLI (temporal, tcld) — not SDK code. Operations: namespace
CRUD, Cloud capacity/APS, API-key rotation, mTLS cert rotation, workflow health,
batch cancel/terminate/reset, export, search attributes, Ops API, billing, audit
logs, Terraform, SAML/SCIM, migration. Diagnosis: bottom-up triage of stuck workflows,
non-determinism, worker-health, task-queue problems, HA failover, payload size limits,
performance bottlenecks, missed schedules. Do NOT trigger for generic TLS/gRPC errors
unrelated to Temporal, writing application code (temporal-developer), or worker
tuning/sizing (temporal-workertuning).'
version: 0.2.1
description: 'Administer and diagnose running Temporal Cloud or self-hosted Temporal Server environments via CLI (temporal, tcld) — not SDK code. Operations: namespace CRUD, Cloud capacity/APS, API-key rotation, mTLS cert rotation, workflow health, batch cancel/terminate/reset, export, search attributes, Ops API, billing, audit logs, Terraform, SAML/SCIM, migration. Diagnosis: bottom-up triage of stuck workflows, non-determinism, worker-health, task-queue problems, HA failover, payload size limits, performance bottlenecks, missed schedules. Do NOT trigger for generic TLS/gRPC errors unrelated to Temporal, writing application code (temporal-developer), or worker tuning/sizing (temporal-workertuning).'
version: 0.2.2
disable-model-invocation: true
---

# Skill: temporal-ops
Expand Down Expand Up @@ -304,4 +297,4 @@ If the layer above the fix is still failing, return to step 4 and continue walki

## Reporting Issues in This Skill

If you (the AI) find this skill's explanations are unclear, misleading, or missing important information, 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-ops/issues/new. Do not file the issue autonomously.
If you (the AI) find this skill's explanations are unclear, misleading, or missing important information, 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-ops/issues/new. Do not file the issue autonomously.
11 changes: 4 additions & 7 deletions plugins/temporal/skills/temporal-serverless/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,8 @@
---
name: temporal-serverless
description: 'Deploy and operate Temporal Workers on serverless compute (AWS Lambda)
driven by the Worker Controller Instance (WCI). Use when the user mentions: "serverless
worker", "Temporal serverless", "Worker Controller Instance", "WCI", "deploy Temporal
worker on Lambda", "Lambda packaging", "Lambda timeout", "WCI inspection", "CloudFormation
Temporal".'
version: 0.6.1
description: 'Deploy and operate Temporal Workers on serverless compute (AWS Lambda) driven by the Worker Controller Instance (WCI). Use when the user mentions: "serverless worker", "Temporal serverless", "Worker Controller Instance", "WCI", "deploy Temporal worker on Lambda", "Lambda packaging", "Lambda timeout", "WCI inspection", "CloudFormation Temporal".'
version: 0.6.2
disable-model-invocation: true
---

# Skill: temporal-serverless
Expand Down Expand Up @@ -244,4 +241,4 @@ Most questions need 2–3 reference files.
- **General SDK development patterns** (Workflows, Activities, signals, queries, Worker Versioning concepts): see `skill-temporal-developer`.
- **Traditional Worker tuning** (slot suppliers, tuners, poller autoscaling, resource-based tuning): see `skill-temporal-workertuning`.
- **Temporal Cloud administration** (Namespaces, users, certificates, billing): see `skill-temporal-ops`.
- **CLI command reference** (beyond the serverless-specific flags): see `skill-temporal-cli`.
- **CLI command reference** (beyond the serverless-specific flags): see `skill-temporal-cli`.