CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

local-temporal

Instructions for running the UI against a local Temporal server build instead of the built-in CLI dev server. Use when asked how to start the dev environment, run the UI locally, or connect to a local Temporal repo.

90

1.25x
Quality

88%

Does it follow best practices?

Impact

100%

1.25x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary concise, actionable dev-setup skill: copy-paste commands for every step, a clear two-terminal workflow, and genuinely non-obvious project knowledge (the ui-server proto-sync gotcha) delivered without padding. The only minor gap is the absence of explicit verification steps (e.g., confirming the server is up before starting the UI).

DimensionReasoningScore

Conciseness

The body is lean and project-specific throughout: exact commands (`make start`, `pnpm dev:local-temporal`, `go build -o ui-server ./cmd/server`), ports (`7233`, `7243`), the `.env.local-temporal` mechanism, and the non-obvious "unknown field" gotcha. Nothing explains concepts Claude already knows; the grpc-gateway paragraph is essential project-specific knowledge that justifies the sync steps. Matches anchor 5 ("every token earns its place"); anchor 4 would require over-explanation that could be trimmed, and none is evident.

5 / 5

Actionability

Every step is a copy-paste-ready command: `make start`, `git checkout <branch-name>` / `make bins`, `pnpm dev:local-temporal`, `grep "go.temporal.io/api" ~/code/temporal/go.mod`, `go get go.temporal.io/api@<version>`, and the build command. The placeholders (<branch-name>, <version>) are appropriate parameterization, not pseudocode. Matches anchor 5 ("fully executable; copy-paste ready; covers the common cases").

5 / 5

Workflow Clarity

The two-terminal structure is clearly sequenced (server first, then UI), and the ui-server sync is a numbered 4-step list with rationale. Helpful anti-error notes exist ("make bins # safe to run even if already built"). Not 5 because there are no explicit validation checkpoints (e.g., verifying the server is listening on 7233/7243 before starting the UI); not 3 because the sequence is fully coherent with no gaps and the failure mode ("unknown field" rejection) is anticipated.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the skill is a single self-contained flow of ~65 lines that needs no external references — all sections (Terminal 1, Terminal 2, why-not-dev, ui-server sync) are short, well-headed, and appropriately inline. Per the rubric's simple-skill guidance, well-organized sections with no need for external files warrant a 5; nothing here clearly belongs in a separate file.

5 / 5

Total

19

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit, concrete "Use when..." trigger clause and a clear what/when split in third-person voice. Its main gap is that it summarizes the skill as a single action rather than naming the specific operations the body actually covers.

Suggestions

Enumerate one or two more concrete capabilities in the description, e.g., "running the UI against a local Temporal server build, starting the server from a local temporalio/temporal checkout, and keeping the ui-server protos in sync with the server branch."

Add trigger-term variations users would naturally say, such as "dev server", "local development", or "temporal server", to broaden natural-language matching.

No other changes needed — the what/when structure and third-person voice are already well executed.

DimensionReasoningScore

Specificity

"Instructions for running the UI against a local Temporal server build instead of the built-in CLI dev server" names the domain and one core action, but does not enumerate the skill's concrete capabilities (starting the Temporal server, running the UI dev server, syncing the ui-server with the server branch). It clearly exceeds anchor 2 ("Processes PDF files"-level domain naming with generic actions) but falls short of anchor 4, which expects several specific listed actions.

3 / 5

Completeness

Explicitly answers both questions: the "what" ("running the UI against a local Temporal server build instead of the built-in CLI dev server") and the "when" ("Use when asked how to start the dev environment, run the UI locally, or connect to a local Temporal repo") with concrete trigger phrases. Matches anchor 5 directly; anchor 4 would require the "when" clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

"Use when asked how to start the dev environment, run the UI locally, or connect to a local Temporal repo" gives three natural phrases a user would plausibly say. Not 5 because common variations are missing — e.g., "dev server", "local development", "temporal server" itself; not 3 because the triggers go beyond a single generic keyword and include the distinctive "local Temporal repo" phrasing.

4 / 5

Distinctiveness Conflict Risk

The local-Temporal-vs-CLI-dev-server distinction carves a clear niche, and "connect to a local Temporal repo" is a distinct trigger. Minor overlap risk remains: "start the dev environment" and "run the UI locally" could also match a generic run-the-app skill, so it is not the minimal-conflict anchor 5; it is clearly more distinct than anchor 3's overlap-prone phrasing.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

temporalio/ui

Path

.claude/skills/local-temporal/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.