Agent skill

Run SDK Tests

by restatedev in restatedev/sdk-typescript

Run the Restate SDK conformance test suite locally against this SDK's Docker image.

MITAuto-check passedTesting & QA

Install Run SDK Tests

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/run-sdk-tests .claude/skills/run-sdk-tests && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .claude/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/run-sdk-tests .agents/skills/run-sdk-tests && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .agents/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/run-sdk-tests .cursor/skills/run-sdk-tests && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .cursor/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/restatedev/sdk-typescript.git --path .claude/skills/run-sdk-tests

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/run-sdk-tests .gemini/skills/run-sdk-tests && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .gemini/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/run-sdk-tests .github/skills/run-sdk-tests && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .github/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install restatedev/sdk-typescript run-sdk-tests --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/restatedev/sdk-typescript.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/run-sdk-tests .opencode/skills/run-sdk-tests && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "run-sdk-tests" agent skill from https://github.com/restatedev/sdk-typescript/tree/main/.claude/skills/run-sdk-tests into .opencode/skills/run-sdk-tests/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "run-sdk-tests", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: run-sdk-tests
GitHub stars: 125
Token cost: ~745 tokens
SKILL.md length: 235 words
Files: 1
Skills in repo: 4
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Run the Restate SDK conformance test suite locally against this SDK's Docker image.

Works in 5 steps: Reads the suite version from… → Builds the service Docker image from the… → Downloads the sdk-tests.jar from GitHub… → …
The user wants to run sdk tests
SKILL.md covers Quick start — use the script, Prerequisites, What the script does and Manual invocation (without the…, plus 3 more sections
Calls java

What it does

Run SDK Tests is an agent skill from restatedev/sdk-typescript. Run the Restate SDK conformance test suite locally against this SDK's Docker image. Use when the user wants to run sdk tests, run conformance tests, verify an implementation, or test against the test suite.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Test generation and Containers. It works with Docker and Java. The repository describes itself as: Restate SDK for JavaScript/Typescript. The licence is MIT.

When your agent uses it

The user wants to run sdk tests
Run conformance tests
Verify an implementation
Test against the test suite

Example prompts

“/run-sdk-tests”

Requirements

Docker

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Reads the suite version from .github/workflows/integration.yaml (single source of truth — no version to keep in sync manually)
Builds the service Docker image from the repo root
Downloads the sdk-tests.jar from GitHub releases and caches it in tmp/ (version-pinned filename)
Pulls the Restate runtime image explicitly
Runs java -jar sdk-tests.jar run ... directly — no Docker wrapper, Java runs on the host

What it can do on your machine

Read from SKILL.md and the folder at commit 79b8358. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- java
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Run SDK Tests loads about 745 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 235 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~55
When it runs · the whole SKILL.md, loaded when a task matches: ~745

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from restatedev/sdk-typescript at commit 79b8358, republished under its MIT licence (© restatedev). 235 words, ~745 tokens.

Download SKILL.mdSave it as .claude/skills/run-sdk-tests/SKILL.md (or your agent's skills folder).

name: run-sdk-tests
description: Run the Restate SDK conformance test suite locally against this SDK's Docker image. Use when the user wants to run sdk tests, run conformance tests, verify an implementation, or test against the test suite.
user-invocable: true

Running SDK Conformance Tests Locally

The conformance test suite lives in a separate repo (restatedev/e2e). It's a Gradle/Kotlin test runner that starts Restate and the SDK service in containers and drives them through the ingress API.

Quick start — use the script

bash

# Build image + run all default suite tests
./.tools/run-sdk-tests.sh

# Skip rebuild if you haven't changed service code
./.tools/run-sdk-tests.sh --skip-build

# Test the restate-sdk-gen services
./.tools/run-sdk-tests.sh --gen

# Run a single test class (extra flags pass through to the runner)
./.tools/run-sdk-tests.sh --skip-build --test-suite=default --test-name=Combinators

Prerequisites

Java 21+
Podman or Docker

What the script does

Reads the suite version from .github/workflows/integration.yaml (single source of truth — no version to keep in sync manually)
Builds the service Docker image from the repo root
Downloads the sdk-tests.jar from GitHub releases and caches it in tmp/ (version-pinned filename)
Pulls the Restate runtime image explicitly
Runs java -jar sdk-tests.jar run ... directly — no Docker wrapper, Java runs on the host

Manual invocation (without the script)

If you need more control, download the JAR and run it directly:

bash

# Check current version
grep -m1 'uses: restatedev/e2e/sdk-tests@' .github/workflows/integration.yaml

# Run
RESTATE_CONTAINER_IMAGE=ghcr.io/restatedev/restate:main \
  java -jar tmp/sdk-tests-<version>.jar run \
  --sequential \
  --image-pull-policy=CACHED \
  --test-suite=default \
  --test-name=Combinators \
  --service-container-image=localhost/e2e-ts-test-services:local

Key flags (passed through to the runner)

Flag	Purpose
`--test-suite=default`	Which suite to run (`default`, `alwaysSuspending`, `threeNodes`, etc.)
`--test-name=ClassName`	Run only one test class (requires `--test-suite`)
`--exclusions-file=path`	YAML file listing tests to skip

Available test suites

Suite	Description
`default`	Core tests, single node
`alwaysSuspending`	Every invocation suspends between steps
`threeNodes`	Multi-node cluster
`persistedTimers`	Forces timer persistence
`lazyState`	Disabled eager state loading

Pass all (the default) to run every suite sequentially.

Reading results

Test logs are written to ../e2e/sdk-tests/test_report/<timestamp>/<suite>/<TestClass>/:

testRunner.log — client-side request/response logs and test execution
runtime_0.log — Restate server log
default-service_0.log — SDK service container log

A ✅ or ❌ per test is printed to stdout immediately.

Files

Just SKILL.md in .claude/skills/run-sdk-tests of restatedev/sdk-typescript.

Open the folder on GitHubat commit 79b8358

Compare with similar skills

Run SDK Tests next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Run SDK Tests compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Run SDK Tests this skillrestatedev/sdk-typescript	125	—	~745	Automated safety check: Pass	MIT	yesterday
Suite ConverterMargin-Lab/evals	161	—	~3.7k	Automated safety check: Pass	AGPL-3.0	2 mo ago
Testcontainers Guide Migratordocker/docs	4.7k	—	~5k	Automated safety check: Pass	Apache-2.0	today
Backend Testingrhesis-ai/rhesis	396	—	~400	Automated safety check: Pass	Custom licence	today
Corvus Bowtie Testingcorvus-dotnet/Corvus.JsonSchema	199	—	~1.4k	Automated safety check: Pass	Apache-2.0	today
PR TestElite588/AUTOGPT	103	—	~9.4k	Automated safety check: Notes	Custom licence	5 mo ago

Similar skills

Suite Converter
Margin-Lab/evals
Converts test suites from external eval frameworks into the Margin Eval suite format.
161 GitHub stars~3.7k tokensUpdated 2 mo ago
Testing & QAAuto-check passed
Testcontainers Guide Migrator
docker/docs
Official
Migrate a Testcontainers guide from testcontainers.com into the Docker docs site (docs.docker.com).
4.7k GitHub stars~5k tokensUpdated today
Testing & QAAuto-check passed
Backend Testing
rhesis-ai/rhesis
Run the backend test suite correctly — working directory, Docker requirement, single-test vs full-suite commands.
396 GitHub stars~400 tokensUpdated today
Testing & QAAuto-check passed
Corvus Bowtie Testing
corvus-dotnet/Corvus.JsonSchema
Test Corvus.JsonSchema against the JSON Schema Test Suite using Bowtie, the cross-implementation meta-validator.
199 GitHub stars~1.4k tokensUpdated today
DevOps & CloudAuto-check passed
PR Test
Elite588/AUTOGPT
E2E manual testing of PRs/branches using docker compose, agent-browser, and API calls.
103 GitHub stars~9.4k tokensUpdated 5 mo ago
Testing & QAAuto-check: notes
Dokan Automation
getdokan/dokan
Build, scaffold, and run the Dokan Lite/Pro Playwright suite.
288 GitHub stars~6.1k tokensUpdated today
Testing & QAAuto-check: notes

Questions about Run SDK Tests

What does Run SDK Tests do?

Run the Restate SDK conformance test suite locally against this SDK's Docker image. Run SDK Tests is an agent skill from restatedev/sdk-typescript. Run the Restate SDK conformance test suite locally against this SDK's Docker image.

When should I use Run SDK Tests?

Run SDK Tests fits situations like: the user wants to run sdk tests; run conformance tests; verify an implementation; test against the test suite.

How do I install Run SDK Tests in Claude Code?

Run `npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a claude-code`. Or copy the skill folder (.claude/skills/run-sdk-tests in restatedev/sdk-typescript) into .claude/skills/run-sdk-tests in your project. Claude Code loads it when a task matches its description.

How do I install Run SDK Tests in Codex?

Run `npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a codex`. Or copy the skill folder (.claude/skills/run-sdk-tests in restatedev/sdk-typescript) into .agents/skills/run-sdk-tests in your project. Codex loads it when a task matches its description.

Can I use Run SDK Tests in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add restatedev/sdk-typescript --skill run-sdk-tests -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-sdk-tests, .gemini/skills/run-sdk-tests, .github/skills/run-sdk-tests and .opencode/skills/run-sdk-tests in your project.

What does Run SDK Tests need to run?

Going by SKILL.md and its folder, Run SDK Tests needs the command-line tools its instructions call (java). Our summary lists: Docker.

Does Run SDK Tests access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run SDK Tests safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Run SDK Tests use?

Run SDK Tests is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run SDK Tests use?

About 745 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Run SDK Tests?

Skills that share tags, products or a category with Run SDK Tests: Suite Converter (Margin-Lab/evals, 161 stars), Testcontainers Guide Migrator (docker/docs, 4.7k stars), Backend Testing (rhesis-ai/rhesis, 396 stars) and Corvus Bowtie Testing (corvus-dotnet/Corvus.JsonSchema, 199 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run SDK Tests?

restatedev (a GitHub organization) maintains it in restatedev/sdk-typescript, which has 125 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 6, 2026.

Source: restatedev/sdk-typescript on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Run SDK Tests

Install Run SDK Tests

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Running SDK Conformance Tests Locally

Quick start — use the script

Prerequisites

What the script does

Manual invocation (without the script)

Key flags (passed through to the runner)

Available test suites

Reading results

Files

Compare with similar skills

Similar skills

Suite Converter

Testcontainers Guide Migrator

Backend Testing

Corvus Bowtie Testing

PR Test

Dokan Automation

More from restatedev/sdk-typescript

Update SDK Test Contracts

Add Config Option

Add E2E Test

Questions about Run SDK Tests

Install Run SDK Tests

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Running SDK Conformance Tests Locally

Quick start — use the script

Prerequisites

What the script does

Manual invocation (without the script)

Key flags (passed through to the runner)

Available test suites

Reading results

Files

Compare with similar skills

Similar skills

More from restatedev/sdk-typescript

Related

Questions about Run SDK Tests