CtrlK
BlogDocsLog inGet started
Tessl Logo

assets-create-folder

Create a new folder under a parent folder inside 'Assets/'. The parent path must start with 'Assets/' and every intermediate folder in it must already exist. Refreshes the AssetDatabase at the end and returns the GUID(s) of the created folder(s).

56

Quality

70%

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/assets-create-folder/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.

A well-structured, actionable tool reference with a real CLI example, stated validation rules, and sensible troubleshooting. Its main weaknesses are redundancy (the description is repeated as prose and the input contract is stated three times) and a placeholder rather than a concrete example payload.

Suggestions

Replace the placeholder `"inputs": "string_value"` in the How to Call example with a concrete payload like `{"inputs": [{"ParentFolderPath": "Assets/Art", "NewFolderName": "Textures"}]}`.

Collapse the triple-stated input contract — merge the "## Inputs" bullet and the "## Input" table into one section, since the JSON schema already restates the structure.

Add an explicit verification step: after running, check the `Errors` field in the response and retry only the failed entries.

DimensionReasoningScore

Conciseness

The body is mostly efficient — validation rules, a concrete CLI call, and compact schemas — but the opening paragraph restates the frontmatter description almost verbatim, and the input contract is explained three times ("## Inputs" prose, "## Input" table, and the Input JSON Schema). Not a 2 because nothing explains concepts Claude already knows; not a 4 because the duplicated overview paragraph and triple-stated input contract are clearly trimmable.

3 / 5

Actionability

Concrete, executable commands are provided (`unity-mcp-cli run-tool assets-create-folder --input ...`) along with real fallbacks (`--input-file args.json`, stdin heredoc) and a troubleshooting note for a missing CLI. It misses a 5 because the primary example uses the placeholder `"inputs": "string_value"` rather than an actual `{ParentFolderPath, NewFolderName}` payload, so the common case isn't copy-paste ready.

4 / 5

Workflow Clarity

The single action is unambiguous (one CLI call), the Validation section enumerates the exact checks the tool performs, and the batch semantics are stated ("per-entry errors are collected in the response so a single bad input does not abort the batch"). Not a 5: there is no explicit feedback loop telling the reader to inspect the `Errors` list in the response and retry failed entries — the batch cap of 3 is avoided because validation rules are stated, but verification of results is left implicit.

4 / 5

Progressive Disclosure

The body has clean, well-ordered sections (Inputs, Validation, How to Call, Troubleshooting, schemas) and no bundle files exist to reference, so nothing is over-nested or buried. Not a 5: at ~120 lines with two full JSON schemas inline, this exceeds the under-50-line simple-skill case, and the bulky schema blocks are content that could live in a references file; still, for a single-tool doc the inline placement is reasonable, keeping it above 3.

4 / 5

Total

15

/

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.

A specific, third-person description that clearly states what the tool does and its constraints, but it omits any 'use when' trigger guidance and never names Unity explicitly, relying on inferred context. Adding a trigger clause and the word 'Unity' would move it firmly into the top tier.

Suggestions

Append a trigger clause such as 'Use when the user wants to create, add, or organize folders in a Unity project's Assets directory.'

Mention 'Unity' explicitly so the skill is discoverable to users who say 'Unity' without knowing 'AssetDatabase' or 'GUID'.

Include natural variations users would say — 'subfolder', 'new directory in the Project window', 'organize assets' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Create a new folder under a parent folder inside 'Assets/'", "Refreshes the AssetDatabase", "returns the GUID(s) of the created folder(s)" — plus explicit path constraints ("must start with 'Assets/'", "every intermediate folder in it must already exist"). It falls short of a 5 because batch behavior (multiple entries), folder-name validation, and error reporting are not covered, leaving minor gaps.

4 / 5

Completeness

The "what" is clear and concrete (create folder, refresh AssetDatabase, return GUIDs), but there is no "Use when..." clause or equivalent trigger guidance — the when is only weakly implied by 'Assets/' context. Per the rubric, a missing 'Use when...' clause caps completeness at 3, and there is nothing here that would lift it to 4.

3 / 5

Trigger Term Quality

Relevant keywords include "folder", "'Assets/'", "AssetDatabase", and "GUID", which a Unity user might say, but the word "Unity" itself never appears and common variations like "subfolder", "project window", or "organize assets" are missing. Not a 4: keyword coverage is serviceable but lacks the natural synonyms and explicit product framing users would use.

3 / 5

Distinctiveness Conflict Risk

"'Assets/'", "AssetDatabase", and "GUID" are Unity-editor-specific terms, giving this a fairly distinct niche unlikely to fire for unrelated file-creation skills. Not a 5 because it never says "Unity", so it could overlap with other Unity asset-management skills (move, rename, delete) whose users would say similar things about folders in 'Assets/'.

4 / 5

Total

14

/

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.