CtrlK
BlogDocsLog inGet started
Tessl Logo

editor-application-set-state

Start / stop / pause the Unity Editor 'playmode'. Use 'editor-application-get-state' to inspect the current state first. Throws if the project currently has compilation errors.

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./Unity-MCP-Plugin/.claude/skills/editor-application-set-state/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The body is a well-structured, largely actionable tool reference with a copy-paste CLI invocation, input/output schemas, and built-in validation semantics. Its main weaknesses are redundant duplicate documentation of the two input parameters and a trivial default-valued example that doesn't demonstrate a meaningful call.

Suggestions

Merge the duplicate "## Inputs" list, "## Input" table, and input JSON schema into a single input section to remove the triple documentation of isPlaying/isPaused.

Show a meaningful example invocation, e.g. --input '{"isPlaying": true}' to start playmode, instead of the no-op all-defaults example.

Add one or two explicit error-recovery steps after the Behavior section (fix the compilation error, re-run the call) to close the feedback loop.

DimensionReasoningScore

Conciseness

The two parameters are documented twice in prose ("## Inputs" — "`isPlaying` (default `false`) — sets `EditorApplication.isPlaying`" and again in the "## Input" table "If true, the 'playmode' will be started..."), a third time in the input JSON schema, and the opening sentence restates the frontmatter description. Mostly efficient reference material with some clear redundancy — anchor 3, not 2 because the bulk (CLI invocation, schemas) earns its tokens.

3 / 5

Actionability

"unity-mcp-cli run-tool editor-application-set-state --input '{...}'" is a fully executable copy-paste command with `--input-file`, stdin-piping variants, and a concrete troubleshooting path ("npm install -g unity-mcp-cli" / "npx unity-mcp-cli"). Minor gap: the shown example passes both default values ("isPlaying": false, "isPaused": false), a no-op invocation rather than a meaningful common case like starting playmode — anchor 4, not 5.

4 / 5

Workflow Clarity

For this simple single-purpose skill the action is unambiguous, with a precondition state-check referenced ("Use 'editor-application-get-state' tool to get the current state first"), built-in validation ("Refuses any state change while `EditorUtility.scriptCompilationFailed` is true"), and a post-change snapshot returned. It stops short of anchor 5 because error recovery is only hinted ("so the caller can fix them first") with no explicit fix-and-retry steps in the body.

4 / 5

Progressive Disclosure

A single-file skill with no bundle files, organized into clear sections (Inputs, Behavior, How to Call, Troubleshooting, Input, Output) and one clearly signaled cross-reference ("Read the /unity-initial-setup skill for detailed installation instructions"). The ~60-line inline output schema is reasonable for a tool doc with no reference files — anchor 4, not 5 because there are no one-level-deep reference files and the schema block could arguably live in a separate reference.

4 / 5

Total

15

/

20

Passed

Description

70%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.

The description is concrete and domain-specific with clear actions and error behavior, but it lacks any 'Use when...' trigger guidance, which caps its completeness. Adding an explicit trigger clause (e.g. "Use when the user wants to run, stop, or pause the Unity Editor play mode") and a few natural synonyms would raise it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to run, stop, pause, or resume the Unity Editor play mode, or to test the game in the editor."

Include common natural synonyms such as "play mode" and "run the game" to broaden trigger-term coverage.

Mention resume behavior (unpause) alongside start/stop/pause for full coverage of the tool's actions.

DimensionReasoningScore

Specificity

"Start / stop / pause the Unity Editor 'playmode'" names the domain and several concrete actions, and "Throws if the project currently has compilation errors" adds concrete error behavior, but coverage has minor gaps (e.g. resume is never mentioned). Fits anchor 4 ('several specific actions; minor gaps') rather than 5's comprehensive coverage.

4 / 5

Completeness

The 'what' is clear and concrete (start/stop/pause playmode, throws on compilation errors), but there is no 'Use when...' clause or equivalent trigger guidance — "Use 'editor-application-get-state' to inspect the current state first" is procedural ordering, not a when-to-use trigger. Per the guideline, a missing trigger clause caps completeness at 3; it does not reach 4 because no 'when' is present even weakly.

3 / 5

Trigger Term Quality

"Unity Editor", "playmode", "start / stop / pause", and "compilation errors" are natural user terms, but common variations like "run", "play mode" (as two words), or "test the game" are missing. Good coverage with a few natural terms absent — anchor 4, not 3 (keywords are more than just 'some relevant') and not 5 (no synonym-level coverage).

4 / 5

Distinctiveness Conflict Risk

"Unity Editor 'playmode'" is a clear niche with a distinct tool reference ('editor-application-get-state') and an explicit error condition, making conflict with other skills unlikely. Matches anchor 5 (clear niche, distinct triggers, minimal conflict risk).

5 / 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
IvanMurzak/Unity-MCP
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.