Skip to content

Commit 5d5caf7

Browse files
ethanruhebecholslennessyy
authored
Add Temporal Cloud Skill and restructure Develop with AI page (#4345)
* Add Temporal Cloud Skill and restructure with-ai page Introduce categorical grouping (Skills vs MCP Server), convert Developer Skill install methods to synced Tabs, and add the new Temporal Cloud Skill for troubleshooting Cloud connectivity, auth, and configuration issues. * Apply suggestion from @bechols Co-authored-by: Ben Echols <benjamin.echols@temporal.io> * Update agent names in documentation * docs: add numbered steps --------- Co-authored-by: Ben Echols <benjamin.echols@temporal.io> Co-authored-by: Lenny Chen <lenny.chen@temporal.io> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>
1 parent e70fc42 commit 5d5caf7

1 file changed

Lines changed: 80 additions & 24 deletions

File tree

docs/with-ai.mdx

Lines changed: 80 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,65 +5,121 @@ sidebar_label: Develop with AI
55
description: Give your AI coding agent Temporal expertise and real-time access to Temporal documentation.
66
---
77

8+
import Tabs from '@theme/Tabs';
9+
import TabItem from '@theme/TabItem';
10+
811
# Develop with AI
912

10-
Give your AI coding agent Temporal expertise with the Temporal Developer Skill and real-time documentation access with the Temporal docs MCP server.
13+
Give your AI coding agent Temporal expertise with Skills and real-time documentation access with the Temporal Docs MCP
14+
Server.
1115

12-
## Temporal Developer Skill
16+
## Skills
1317

14-
The [Temporal Developer Skill](https://github.com/temporalio/skill-temporal-developer) gives your AI coding agent expert-level knowledge of Temporal's programming model — workflow determinism rules, activity patterns, retry policies, error handling, testing strategies, worker configuration, versioning, and common gotchas.
18+
Skills give AI agents domain-specific Temporal expertise. They work with Claude Code, Codex, Cursor, and any agent that
19+
supports [Skills](https://agentskills.io).
1520

16-
It works with Claude Code, Codex, Cursor, and any agent that supports [Skills](https://agentskills.io).
21+
### Temporal Developer Skill
1722

18-
### Claude Code Plugin
23+
The [Temporal Developer Skill](https://github.com/temporalio/skill-temporal-developer) gives your AI coding agent
24+
expert-level knowledge of Temporal's programming model — workflow determinism rules, activity patterns, retry policies,
25+
error handling, testing strategies, worker configuration, versioning, and common gotchas.
1926

20-
```bash
21-
/plugin marketplace add temporalio/agent-skills
22-
```
27+
<Tabs groupId="skill-install" queryString>
28+
<TabItem value="claude-code" label="Claude Code Plugin">
29+
30+
1. Add the Temporal skills marketplace to Claude Code:
2331

24-
Then open the plugin manager, select the marketplace, and install `temporal-developer`.
32+
```bash
33+
/plugin marketplace add temporalio/agent-skills
34+
```
2535

26-
### npx skills
36+
2. Open the plugin manager by running `/plugin` within Claude Code, select the marketplace, and install
37+
`temporal-developer`.
2738

28-
Works with Cline and other agents:
39+
</TabItem>
40+
<TabItem value="npx" label="npx">
41+
42+
This works with Claude Code, Codex, Cline, and other agents.
43+
44+
Install the skill using the `skills` CLI:
2945

3046
```bash
3147
npx skills add https://github.com/temporalio/skill-temporal-developer
3248
```
3349

34-
### Manual
50+
</TabItem>
51+
<TabItem value="manual" label="Manual">
52+
53+
Clone the skill repository into your Claude skills directory. Change the target directory if you are using agents other
54+
than Claude:
3555

3656
```bash
3757
git clone https://github.com/temporalio/skill-temporal-developer.git ~/.claude/skills/temporal-developer
3858
```
3959

60+
</TabItem>
61+
</Tabs>
62+
4063
Restart your coding agent after installing.
4164

42-
## Temporal Docs MCP Server
65+
### Temporal Cloud Skill
4366

44-
Connect Temporal documentation directly to your AI assistant for accurate, up-to-date answers about Temporal.
45-
The Temporal docs MCP server gives AI tools real-time access to our documentation, so responses draw from current docs rather than training data.
67+
The [Temporal Cloud Skill](https://github.com/temporalio/skill-temporal-cloud) helps your AI coding agent troubleshoot
68+
Temporal Cloud connectivity, authentication, and configuration issues.
4669

47-
The server requires anonymous authentication using any Google account to enforce rate limits and prevent abuse.
48-
We cannot see nor do we collect any contact information from this.
70+
<Tabs groupId="skill-install" queryString>
71+
<TabItem value="npx" label="npx">
4972

50-
### Claude Code
73+
This works with Claude Code, Codex, Cline, and other agents.
5174

52-
Add the Temporal docs MCP server to Claude Code with a single command:
75+
Install the skill using the `skills` CLI:
5376

5477
```bash
55-
claude mcp add --scope user --transport http temporal-docs https://temporal.mcp.kapa.ai
78+
npx skills add https://github.com/temporalio/skill-temporal-cloud
5679
```
5780

58-
This adds the server globally so it's available in all your projects.
81+
</TabItem>
82+
<TabItem value="manual" label="Manual">
5983

60-
To add it to a specific project only (stored in `.mcp.json`):
84+
Clone the skill repository into your Claude skills directory. Change the target directory if you are using agents other
85+
than Claude:
6186

6287
```bash
63-
claude mcp add --transport http temporal-docs https://temporal.mcp.kapa.ai
88+
git clone https://github.com/temporalio/skill-temporal-cloud.git ~/.claude/skills/temporal-cloud
6489
```
6590

66-
After adding, restart Claude Code and run `/mcp` to authenticate with your Google account.
91+
</TabItem>
92+
</Tabs>
93+
94+
Restart your coding agent after installing.
95+
96+
## Temporal Docs MCP Server
97+
98+
Connect Temporal documentation directly to your AI assistant for accurate, up-to-date answers about Temporal. The
99+
Temporal docs MCP server gives AI tools real-time access to our documentation, so responses draw from current docs
100+
rather than training data.
101+
102+
The server requires anonymous authentication using any Google account to enforce rate limits and prevent abuse. We
103+
cannot see nor do we collect any contact information from this.
104+
105+
### Claude Code
106+
107+
Add the Temporal docs MCP server globally so it's available in all your projects:
108+
109+
1. Register the MCP server with Claude Code:
110+
111+
```bash
112+
claude mcp add --scope user --transport http temporal-docs https://temporal.mcp.kapa.ai
113+
```
114+
115+
2. Restart Claude Code and run `/mcp` to authenticate with your Google account.
116+
117+
To add the server to a specific project only, omit the `--scope user` flag. This stores the configuration in the
118+
project's `.mcp.json` file:
119+
120+
```bash
121+
claude mcp add --transport http temporal-docs https://temporal.mcp.kapa.ai
122+
```
67123

68124
### Claude Desktop
69125

0 commit comments

Comments
 (0)