CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

godot-4-migration

Specialized guide for migrating Godot 3.x projects to Godot 4 (GDScript 2.0), covering syntax changes, Tweens, and exports.

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 ./skills/godot-4-migration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 strong, code-first migration reference with excellent executable before/after examples and good token efficiency. Its main weakness is that migration is presented as a lookup catalog rather than a sequenced workflow with validation checkpoints.

Suggestions

Add a short ordered migration workflow with validation steps (e.g., 1. Identify deprecated patterns, 2. Apply conversions, 3. Run the project, 4. Fix errors using the Troubleshooting section, re-run until clean).

Trim the redundant Overview section, which restates the frontmatter description without adding guidance.

Consider moving the exhaustive syntax-change mapping to a references file, keeping SKILL.md as the headline changes plus examples.

DimensionReasoningScore

Conciseness

The body is lean: short before/after code pairs for each change with minimal prose. Minor over-explanation could be trimmed — the Overview section ('A critical guide for developers transitioning...') restates the frontmatter description, and lines like 'GDScript 2.0 supports typed arrays for better performance and type safety' add rationale Claude doesn't need. Not level 5 because a few sentences don't earn their place; not level 3 because there is no padded or redundant section of substance.

4 / 5

Actionability

Every key change is shown as copy-paste-ready, executable GDScript in a before/after pair (annotations, set/get syntax, create_tween() chains, callable signal connections, typed arrays, await), and the examples cover the common migration cases. The only ellipsis appears on the deprecated Godot 3 side ('$Tween.interpolate_property(...)'), which is being replaced, so it doesn't reduce actionability.

5 / 5

Workflow Clarity

The content is organized as a change catalog with When-to-Use and Troubleshooting sections, but migration is a multi-step process and no sequence is given (e.g., check project settings, convert, run, fix errors, re-test) and validation checkpoints are absent — only one troubleshooting entry serves as error recovery. It is above level 2 because the structure is coherent and each transformation is unambiguous, but it lacks the sequence-plus-checkpoints of level 4.

3 / 5

Progressive Disclosure

The skill is a single ~120-line file with well-organized sections (Overview, When to Use, Key Changes, Examples, Best Practices, Troubleshooting) and no nested or buried references; no bundle files exist, so nothing is mis-split. It falls short of level 5 because the body exceeds the simple-skill threshold and a deeper change reference (Godot's full 3-to-4 changeset is large) could be offloaded to a separate file.

4 / 5

Total

16

/

20

Passed

Description

65%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, well-targeted description with a clear niche and strong domain keywords, but it lacks any 'Use when...' trigger clause and enumerates topics rather than concrete actions. Adding explicit trigger guidance would lift its weakest dimensions.

Suggestions

Append an explicit trigger clause, e.g. 'Use when porting or upgrading a Godot 3 project to Godot 4, fixing GDScript 2.0 syntax errors, or replacing deprecated Tween nodes and export keywords.'

Add natural synonyms users would say ('port', 'upgrade', 'Godot 3', '.gd files') to broaden trigger-term coverage.

Rephrase coverage as concrete actions (e.g., 'converts setget syntax, replaces Tween nodes with create_tween(), and updates export keywords') to strengthen specificity.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action ("migrating Godot 3.x projects to Godot 4") plus three specific topic areas ("syntax changes, Tweens, and exports"), but the coverage reads as topic nouns rather than enumerated actions, and notable areas (signals, await) are absent. It fits the 'names domain and concrete actions, but not comprehensive' anchor better than the 'lists several specific actions; minor gaps' anchor, though it sits slightly above the level-3 example.

3 / 5

Completeness

The 'what' is clear ("Specialized guide for migrating Godot 3.x projects to Godot 4 (GDScript 2.0), covering syntax changes, Tweens, and exports"), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by the migration framing. Per the judging guidelines, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: "Godot 3.x", "Godot 4", "GDScript 2.0", "Tweens", "exports", "migrating". A few natural synonyms are missing ("port/porting", "upgrade", ".gd", "project.godot"), so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Godot 3.x-to-4 migration) with distinct triggers ("Godot 4", "GDScript 2.0", "Tween", "export"), so it is unlikely to fire for unrelated skills. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor; it is not the level-4 anchor because the risk of overlap is minimal, not merely minor.

5 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/godot-4-migration/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.