CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloudfiles

CloudFiles integration. Manage data, records, and automate workflows. Use when the user wants to interact with CloudFiles data.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/cloudfiles/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 provides concrete, executable Membrane CLI guidance covering installation, authentication (including headless fallback), connection setup with state-based polling and error handling, action discovery, and a proxy fallback, all in a well-organized single file. The main defects are a dangling 'Step 2' cross-reference, an official-docs link pointing to the wrong product (Rackspace Cloud Files), and light marketing padding.

Suggestions

Fix the dangling 'skip to Step 2' reference by numbering the workflow steps explicitly, and add a validation checkpoint after running an action (e.g. check the output field for errors before reporting success).

Correct the 'Official docs' link: rackspace.com/cloud/cloud-files is a different product from the cloudfiles.io sales platform the body documents.

Trim the marketing-style overview sentence and move the proxy flag table / clientAction state details into a references file so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The body is command-focused with little concept explanation Claude already knows, matching anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed'). Padding is present but limited: 'It's used by sales and marketing professionals to improve their sales process and content effectiveness' and the 'This is the fastest way to get a connection' sentence. Not 5 because the marketing-style overview sentences and the empty entity list ('File / File Content / File Metadata / Folder / Account / Shared Link' followed only by 'Use action names and parameters as needed') spend tokens without instructing anything.

4 / 5

Actionability

The body is largely copy-paste executable: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.cloudfiles.io/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {...} --json', plus a complete proxy flag table. Matches anchor 4 ('Mostly executable guidance; concrete code or commands with minor gaps'). Not 5 because 'membrane login --tenant --clientName=<agentType>' leaves --tenant without a value, and the 'Official docs: https://www.rackspace.com/cloud/cloud-files' link points to Rackspace Cloud Files, a different product from the cloudfiles.io sales platform the body describes.

4 / 5

Workflow Clarity

A clear sequence runs install → authenticate (with headless fallback) → connect → poll connection state → discover actions → run/proxy, with state-based branching ('READY', 'CLIENT_ACTION_REQUIRED' with its clientAction fields, 'CONFIGURATION_ERROR'/'SETUP_FAILED') acting as explicit checkpoints, matching anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps'). Not 5 because 'skip to Step 2' references a Step 2 that does not exist (sections are unnumbered), and there is no verification step after running an action.

4 / 5

Progressive Disclosure

The skill is a single well-sectioned SKILL.md with no bundle directories and no references to any external files, so nothing is nested or mislinked, matching anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps'). Not 5 because at ~144 lines the connection-state machine and the proxy options table are detailed reference material that could live in a separate file to keep SKILL.md a lean overview.

4 / 5

Total

16

/

20

Passed

Description

57%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 names the CloudFiles domain and includes an explicit 'Use when...' trigger clause, satisfying the completeness floor. However, its capability verbs are generic ('manage data, records, and automate workflows') and its trigger vocabulary reduces to the product name alone, missing the natural terms (trackable sales content, document sharing, engagement analytics) that would let Claude select this skill reliably.

Suggestions

Replace the generic verbs with concrete CloudFiles operations, e.g. 'Share sales documents and presentations via trackable links, view prospect engagement analytics, and manage files, folders, and records in CloudFiles.'

Add natural trigger terms to the when-clause, e.g. 'Use when the user mentions CloudFiles, trackable links or sales documents, or wants engagement analytics on shared content.'

Drop the buzzword 'automate workflows' or tie it to a concrete capability, since it currently adds no information a user would match against.

DimensionReasoningScore

Specificity

The description names the domain ('CloudFiles integration') but its action verbs — 'Manage data, records, and automate workflows' — are generic abstractions with no concrete operations (no 'create trackable links', 'view engagement analytics', or 'share documents'). This matches anchor 2 ('Names the domain but actions are minimal or generic'); not 3 because 'manage' and 'automate' are not concrete actions.

2 / 5

Completeness

Both components are explicitly present: a what ('Manage data, records, and automate workflows') and an explicit when ('Use when the user wants to interact with CloudFiles data'), matching anchor 4 ('Has both what and when; when could be more explicit or specific'). Not 5 because the what is generic rather than concrete and the when offers only a single trigger phrase; not 3 because the when is explicit, not weakly implied.

4 / 5

Trigger Term Quality

'CloudFiles' (used twice, including in the trigger 'Use when the user wants to interact with CloudFiles data') is the one natural keyword a user would say, but the remaining terms ('data', 'records', 'workflows') are generic and miss phrases a sales-content platform user would actually use. Fits anchor 3 ('Some relevant keywords but missing common variations or synonyms'); not 4 because coverage beyond the product name is thin.

3 / 5

Distinctiveness Conflict Risk

Anchoring both the capability statement and the trigger on the distinct product name 'CloudFiles' makes this mostly distinguishable, matching anchor 4 ('Mostly distinct; minor overlap risk'). Not 5 because the generic verbs 'Manage data, records, and automate workflows' create some overlap risk with other data-management/automation skills.

4 / 5

Total

13

/

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