CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

modly-cli

Use when an agent needs to call a running Modly desktop instance from the terminal to generate/export image-to-3D assets through canonical JSON-first automation commands.

Quality

81%

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

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.

A strong, highly actionable CLI skill: executable commands throughout, clear sequencing with validation checkpoints, recovery metadata, and a verification checklist. The main weaknesses are a missing bundle (the referenced CLI script and test file are not present, so no referenced path can be resolved) and some inlining/duplication of non-canonical material.

Suggestions

Ship the referenced CLI in the bundle (e.g. under scripts/ or as the referenced tools/modly-cli/ path) so 'python tools/modly-cli/agent.py ...' commands and the 'python tools/modly-cli/test_agent.py' checklist item actually resolve for the reader.

Move the Legacy Compatibility, Experimental ComfyUI Helpers, and Developer-Only API Helpers sections into a clearly signaled one-level-deep reference file (e.g. ADVANCED.md), keeping SKILL.md focused on the canonical contract.

Deduplicate the hidden-helper guidance: the hidden 'export' helper and hidden top-level aliases are each described twice (in Canonical Commands and in Hidden Helper Aliases).

DimensionReasoningScore

Conciseness

The body is efficient and command-first with no explanations of known concepts, but minor duplication could be trimmed — the hidden 'export' helper and hidden-alias guidance appears in both 'Canonical Commands' ('Use --no-export when the caller only needs the workspace path. The hidden export helper remains available...') and again in 'Hidden Helper Aliases' ('The top-level status, export, and batch helpers remain parseable for older scripts...').

4 / 5

Actionability

Every section provides copy-paste-ready executable commands with concrete flags (e.g. 'workflow-run start --image ./input.png --wait', 'generate --image ./input.png --output ./export.glb --progress'), concrete JSON output samples, and a verification checklist covering the common cases including batch manifests.

5 / 5

Workflow Clarity

The primary workflow is clearly sequenced (launch desktop app -> 'health' readiness check -> generate --wait -> verify export_path exists) with explicit validation (health gating, verification checklist) and real feedback loops (structured failure JSON with codes like API_UNAVAILABLE, recovery metadata with status_command/cancel_command). The batch workflow is covered with --continue-on-error and the checklist, so the batch-validation cap is not triggered.

5 / 5

Progressive Disclosure

Sections are well-organized, but the body's core referenced paths ('tools/modly-cli/agent.py', 'tools/modly-cli/test_agent.py') do not exist in the bundle — there are no references/, scripts/, or assets/ directories at all — so navigation to deeper material is unresolvable. Additionally, auxiliary surfaces (Legacy Compatibility, Experimental ComfyUI Helpers, Developer-Only API Helpers, hidden aliases) are inlined in SKILL.md where one-level-deep reference files would keep the overview leaner.

3 / 5

Total

17

/

20

Passed

Description

73%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 solid description with an explicit 'Use when...' clause, a clear what/when pairing, third-person voice, and a highly distinctive product-specific niche. Its main gap is breadth of the action list and missing natural synonyms/file extensions that would improve trigger matching.

Suggestions

Broaden the action list to match the skill's real surface, e.g. 'generate and export image-to-3D assets, inspect models, start and monitor workflow runs, and batch-generate meshes'.

Add natural synonyms and the output extension users would actually say — '3D model', 'mesh', '.glb' — so trigger matching catches common phrasings beyond 'image-to-3D assets'.

DimensionReasoningScore

Specificity

The description names the domain ('running Modly desktop instance', 'image-to-3D assets') and the concrete actions 'generate/export' through 'canonical JSON-first automation commands', but coverage is narrow — it omits model inspection, workflow-run management, cancellation, and batch generation that the skill actually provides. This matches anchor 3 (domain and 1-2 concrete actions, not comprehensive) better than anchor 4's 'several specific actions'.

3 / 5

Completeness

Both parts are explicit: what = 'generate/export image-to-3D assets through canonical JSON-first automation commands', and when = 'Use when an agent needs to call a running Modly desktop instance from the terminal'. It is not a clear anchor 5 because the when-clause is framed around the agent's internal need rather than concrete user-side trigger phrases ('when the user wants to turn an image into a 3D model / export a mesh').

4 / 5

Trigger Term Quality

Good keyword coverage of the natural terms a user would say: 'Modly', 'image-to-3D', 'generate', 'export', 'terminal'. It falls between anchors 3 and 4 — a few common synonyms and the output-file extension ('3D model', 'mesh', '.glb') are missing, but the core natural phrasing is present, so it is noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

'Modly' is a distinctive product name and image-to-3D asset generation is a clear niche with distinct triggers, so overlap with other skills is minimal — a direct match for anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

lightningpixel/modly

Path

tools/modly-cli/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.