CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rql-query

Query the live Unity scene (GameObjects, components, assets) with RQL in ONE call: filter, project, sort, count, walk hierarchies. Far fewer calls/tokens than reading objects one by one.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 dense reference skill: every section delivers information Claude could not know (a custom DSL) with executable commands, concrete examples, and built-in error-recovery hints. The only weakness is minor redundancy in the invocation boilerplate and the duplicated input specification.

DimensionReasoningScore

Conciseness

Dense, reference-style content that assumes competence — no padding explaining Unity or basic concepts, and the RQL spec lines each earn their place. Not 5 because of minor trimmable redundancy: the Input JSON schema block restates the input table, and the generic CLI invocation boilerplate (input-file/stdin heredoc block) is padded relative to this skill's single-string input. Not 3 because over-explanation is minor, not 'some unnecessary explanation' throughout.

4 / 5

Actionability

Fully executable guidance: a copy-paste CLI command, an stdin variant for complex input, a concrete fallback ('npx unity-mcp-cli'), an input table, and 8 concrete example queries covering common cases — matching the 5 anchor's 'copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

A single-action read-only skill with an unambiguous invocation path (how to call, what input, expected output format), plus explicit error-recovery guidance ('Unknown members produce warnings with suggestions; rql-schema(type) lists a type's members', truncated-results refinement, CLI-not-found troubleshooting). The simple-skill exception applies and the operation is neither destructive nor batch, so no validation cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories) and none are needed at this size; the body is well-organized under clear sections (syntax reference → examples → how to call → troubleshooting → input → output). The under-50-lines simple-skill exception applies: well-organized sections with no need for external references.

5 / 5

Total

19

/

20

Passed

Description

75%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 highly specific, well-scoped description that clearly states what the skill does with concrete action verbs and domain objects. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which both caps completeness and limits natural trigger-term coverage.

Suggestions

Add an explicit trigger clause, e.g. 'Use when you need to search, inspect, filter, or aggregate GameObjects and components in a live Unity Editor scene instead of reading them one by one.'

Include natural synonyms users would actually say — 'search', 'find', 'inspect', 'hierarchy' — alongside 'query' and 'walk hierarchies' to broaden trigger-term coverage.

Clarify the boundary in the description itself (e.g. 'read-only; for changes use rql-mutate') so it is distinguishable from the mutation skill at trigger time, not only in the body.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions ('filter, project, sort, count, walk hierarchies') scoped to a concrete domain ('GameObjects, components, assets'), matching the comprehensive-coverage anchor; better fit than the 4 anchor, which allows minor gaps.

5 / 5

Completeness

The 'what' is clear and concrete (query the live Unity scene with RQL: filter, project, sort, count, walk hierarchies), but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'Far fewer calls/tokens than reading objects one by one' is a benefit statement, only weakly implying 'when'. Per the judging guidelines this caps completeness at 3; not 4 because 'when' is not present even implicitly-specific form.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('Unity scene', 'GameObjects', 'components', 'assets', 'hierarchies') that Unity users would say, but misses common variations like 'search', 'find', or 'inspect'. Not 5 because synonym coverage is not comprehensive; not 3 because the terms present are natural and domain-relevant rather than generic.

4 / 5

Distinctiveness Conflict Risk

Clear niche — RQL queries against the live Unity Editor scene — with distinct triggers and minimal overlap with other skills, matching the 5 anchor's 'clear niche with distinct triggers'.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

IvanMurzak/Unity-MCP

Path

Unity-MCP-Plugin/.claude/skills/rql-query/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.