CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloud-convert

Cloud Convert integration. Manage Deals, Persons, Organizations, Leads, Projects, Pipelines and more. Use when the user wants to interact with Cloud Convert data.

Quality

62%

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/cloud-convert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 delivers concrete, copy-paste-ready Membrane CLI commands with a genuinely well-handled connection-state feedback loop, but it carries some conceptual padding, never demonstrates a complete end-to-end conversion with real parameters, and omits post-execution validation for job/task completion despite destructive and batch actions. Structure is clean and navigable within a single file.

Suggestions

Trim the introductory background ("CloudConvert is an online file conversion tool that supports a wide variety of file formats... It's used by individuals and businesses...") and the filler line "Use action names and parameters as needed."

Add one worked end-to-end example — e.g. a create-job command with a real tasks payload followed by polling get-job until the job finishes — covering the most common conversion case and supplying the missing validation/feedback loop.

Fix the "skip to Step 2" reference (no Step 2 is labeled in the document) and label the connection steps consistently.

DimensionReasoningScore

Conciseness

The body is mostly tight, executable command blocks, but contains unnecessary explanation such as "It's used by individuals and businesses who need to convert documents, images, audio, and video files" (background Claude does not need) and filler like "Use action names and parameters as needed." It fits anchor 3 (mostly efficient, some unnecessary explanation) rather than 4 because there are several such sentences, and not 2 because the bulk is lean command documentation.

3 / 5

Actionability

Concrete, copy-paste-ready commands throughout — "npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://cloudconvert.com\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json" — plus an 18-action catalog and a proxy flag table. It is anchor 4 rather than 5 because no worked example with real parameters is shown (e.g. an actual convert-file or create-job input), so the reader must discover inputSchema separately; the generic '{"key": "value"}' placeholder leaves a minor gap.

4 / 5

Workflow Clarity

The install → login → connection → search → run sequence is clear, with a good connection-state feedback loop (READY / CLIENT_ACTION_REQUIRED with re-poll instructions / CONFIGURATION_ERROR with error-field checking). However, "skip to Step 2" references a step that is never labeled, and there is no validation after execution — no instruction to poll get-job/get-task until a conversion finishes — despite the catalog including destructive and batch operations ("Delete a job and all its tasks", "Create a new conversion job with multiple tasks"), which caps this at anchor 3 per the rubric.

3 / 5

Progressive Disclosure

A single self-contained file with well-organized, clearly headed sections (Install the CLI, Authentication, Connecting, Searching for actions, Popular actions, Running actions, Proxy requests, Best practices) and no nested or buried references — no bundle files exist to verify. It is anchor 4 rather than 5 because at ~160 lines the 18-row action table and proxy details could be split into a reference file, and not 3 because nothing is buried and navigation is easy.

4 / 5

Total

14

/

20

Passed

Description

46%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 includes an explicit 'Use when' trigger but describes the wrong domain: it lists CRM entities (Deals, Persons, Organizations, Leads, Projects, Pipelines) that have nothing to do with CloudConvert's file-conversion functionality shown in the body, and it never mentions the core capability of converting files between formats. Trigger coverage rests solely on the brand name, missing natural conversion vocabulary users would say.

Suggestions

Rewrite the description around the skill's actual capabilities, e.g. "Convert files between formats (documents, images, audio, video), create multi-task conversion jobs, and import/export files via URL. Use when the user wants to convert a file from one format to another or mentions CloudConvert."

Remove the CRM entity list ("Deals, Persons, Organizations, Leads, Projects, Pipelines") — these wrong-domain nouns will mis-trigger the skill for CRM requests and collide with CRM integration skills.

Add natural trigger terms users would actually say — "convert file", "file conversion", "PDF to Word", "change file format" — instead of relying only on the brand name.

DimensionReasoningScore

Specificity

"Manage Deals, Persons, Organizations, Leads, Projects, Pipelines and more" offers only the generic verb "Manage" while never naming the skill's actual capabilities (converting, importing, or exporting files); it names the domain but the actions are minimal or generic, matching anchor 2. It is not 3 because no concrete CloudConvert action is described, and not 1 because the domain and objects are explicitly named.

2 / 5

Completeness

Both parts are explicitly stated: what ("Cloud Convert integration. Manage Deals, Persons, Organizations, Leads, Projects, Pipelines and more") and when ("Use when the user wants to interact with Cloud Convert data"). It is not 5 because the 'when' is circular (only fires when the product is named) and the 'what' omits the core conversion capability, and not 3 because an explicit 'Use when...' clause is present.

4 / 5

Trigger Term Quality

The only natural keyword is the brand name "Cloud Convert"; the phrases users would actually say for file conversion ("convert file", "file conversion", "PDF to Word", "change format", file extensions) are all absent, and "interact with Cloud Convert data" is not a phrase users say. This lands at anchor 2 (one or two generic keywords, missing natural phrases) rather than 3, since beyond the brand name there is no relevant conversion vocabulary.

2 / 5

Distinctiveness Conflict Risk

The trigger clause "Use when the user wants to interact with Cloud Convert data" is product-specific, but "Deals, Persons, Organizations, Leads, Projects, Pipelines" are classic CRM nouns that would collide with CRM integration skills and capture wrong intents. It is somewhat specific but could still overlap with similar skills (anchor 3), not 4 because of that entity-list overlap, and not 2 because the explicit trigger names the exact product.

3 / 5

Total

11

/

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

membranedev/application-skills

Path

skills/cloud-convert/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.