CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rql-schema

List RQL sources and the component types present in the loaded scenes; pass a type name for its members.

Quality

76%

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/rql-schema/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 tight, well-structured reference for a single tool call: exact executable commands, a clear input specification, and practical troubleshooting. Its only flaws are minor redundancy between the prose summary, the input table, and the JSON schema block, plus a placeholder value in the main example. Structure and workflow guidance are fully appropriate for a skill of this size.

DimensionReasoningScore

Conciseness

The body is lean: a one-paragraph purpose statement, a copy-paste command with two invocation alternatives, a compact input table, and a one-line output note — no explanations of concepts Claude already knows. It is not 5 because the input table and the Input JSON Schema are redundant (both say 'type: string, optional') and the opening paragraph repeats the frontmatter description almost verbatim.

4 / 5

Actionability

Concrete, executable bash commands are given for all three invocation styles, plus actionable troubleshooting ('npm install -g unity-mcp-cli' or 'npx unity-mcp-cli'). It falls short of 5 only because the primary example uses the placeholder '"string_value"' instead of a realistic value like "Light", which the surrounding text mentions but the runnable example does not.

4 / 5

Workflow Clarity

This is a simple, single-action skill (one read-only CLI invocation with an optional argument), and the single action is unambiguous: exact command, input spec, invocation alternatives, and failure recovery are all specified. The scoring note for simple skills allows a 5 here; no validation checkpoints are needed since the operation is non-destructive and non-batch.

5 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files to disclose, and needs none — the content fits comfortably inline. Sections (How to Call, Troubleshooting, Input, Output) are well-organized, and the only external pointer ('Read the /unity-initial-setup skill') is clearly signaled and one level deep.

5 / 5

Total

18

/

20

Passed

Description

58%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, clearly stating what the tool lists and how the optional type-name parameter changes the output. Its main weaknesses are the absence of any explicit 'use when' trigger guidance and limited natural-language keyword coverage, both of which reduce discoverability. Adding a trigger clause with user-facing terms (Unity components, scene types, inspecting a component) would lift the two lowest dimensions.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when exploring an unfamiliar Unity scene or before querying a component type you have not seen.'

Include natural user phrasings and synonyms such as 'Unity components', 'scene components', 'component members', or 'inspect a type' alongside the RQL jargon.

Mention the additional capabilities documented in the body (methods, read-only flags, GameObject/Transform members) so the description's coverage is more comprehensive.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "List RQL sources and the component types present in the loaded scenes" and "pass a type name for its members" — matching the anchor for several specific actions with minor gaps (methods, asset functions, and GameObject/Transform members are only covered in the body, not the description). Not score 5 because coverage is not comprehensive, and not 3 because it goes beyond the 1–2 actions of that anchor.

4 / 5

Completeness

The 'what' is clearly stated (list sources, component types with their members), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is at best weakly implied by "pass a type name". Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ("RQL sources", "component types", "loaded scenes", "type name", "members") but common variations and synonyms a user might naturally say (e.g., "Unity components", "inspect a component", "scene schema") are missing. It sits between the 'some relevant keywords' (3) and 'good keyword coverage' (4) anchors, closer to 3 given the jargon-heavy phrasing.

3 / 5

Distinctiveness Conflict Risk

The RQL/Unity component-schema niche is fairly distinct with domain-specific terms, so it is unlikely to trigger generic skills by mistake. It is not 5 because without explicit trigger phrasing it has minor overlap risk with closely related sibling skills in the same RQL tool family (e.g., a query-oriented rql skill).

4 / 5

Total

14

/

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-schema/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.