CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

algorithmia

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

Quality

66%

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/algorithmia/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 is a solid, actionable CLI-driven guide with concrete commands, JSON output paths, and a useful action catalog plus proxy fallback. Its main weaknesses are a redundant conceptual intro explaining what Algorithmia is, and the complete absence of validation guidance for the destructive actions it exposes.

Suggestions

Delete the opening paragraph explaining what Algorithmia is and the bare "Algorithmia Overview" term hierarchy; Claude already knows the platform, and the description already covers it.

Add validation guidance for destructive actions, e.g. "Before delete-file/delete-directory, run list-directory to show the user what will be removed and confirm".

Show one fully concrete action invocation (e.g. membrane action run with list-directory and a real --input payload) instead of only placeholder examples.

DimensionReasoningScore

Conciseness

The body opens by explaining what Algorithmia is ("Algorithmia is a platform for deploying and scaling machine learning models. Data scientists and developers use it to productionize their models..."), a concept Claude already knows, and includes padding like the bare "Algorithmia Overview" term hierarchy followed by "Use action names and parameters as needed." The remainder (CLI setup, action table, proxy flags) is mostly efficient, so this fits anchor 3 rather than 2's several padded sections.

3 / 5

Actionability

Guidance is mostly executable: copy-paste commands for install ("npm install -g @membranehq/cli"), login (including the headless variant), connection (with the exact JSON path "output.items[0].element?.id"), action discovery, action run with --input JSON, and a proxy flags table. It falls short of 5 only because the action-run examples stop at generic placeholders and never show one complete invocation with a real action key such as list-directory.

4 / 5

Workflow Clarity

There is a sensible install → login → connect → discover → run sequence, and a checkpoint for checking existing connections, but there are no validation or verification steps anywhere. Since the skill covers destructive operations (delete-file, delete-directory) and batch-capable list/execute operations with no confirm-or-verify guidance, workflow clarity is capped at 3 per the destructive-operations rule; it is above 2 because the sequence itself is clearly defined.

3 / 5

Progressive Disclosure

The file is well structured with clear, logically ordered sections (setup, connecting, actions, proxy, best practices) and no nested references — everything is one level deep. The 15-row popular-actions table is modest bulk kept inline, which is acceptable at this size but is the kind of content that anchor 5 would place in a well-signaled separate reference file; this fits anchor 4's "minor organization gaps".

4 / 5

Total

14

/

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 correctly names the Algorithmia niche and includes an explicit 'Use when' clause, giving it adequate completeness and distinctiveness. However, the capability statement is generic — it never mentions the platform's actual operations (executing algorithms, managing data directories, publishing versions) — so it reads closer to a template than a precise trigger.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete actions, e.g. "Execute algorithms, manage data directories (upload/download/delete files), create and publish algorithm versions".

Enrich the 'when' clause with natural trigger phrases users would say, e.g. "Use when the user mentions Algorithmia, running algorithms, or managing Algorithmia data directories".

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Algorithmia domain but the actions are generic — there are no concrete operations like "execute algorithms", "upload files to data directories", or "publish algorithm versions". It matches the anchor "Names the domain but actions are minimal or generic" rather than 3, which requires 1-2 concrete named actions.

2 / 5

Completeness

Both parts are explicitly present: "what" ("Manage data, records, and automate workflows") and "when" ("Use when the user wants to interact with Algorithmia data"). The 'when' clause is explicit but generic and the 'what' is vague, fitting anchor 4 ("both present; 'when' could be more explicit") rather than 5's concrete trigger phrases — and it is above 3 because the 'Use when' clause is not merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ("Algorithmia", "data", "records", "workflows") but common natural variations users would say — "algorithms", "models", "API", "data directories", "files" — are missing. It has some relevant keywords but is missing synonyms and variations, matching anchor 3 rather than 4's fuller coverage.

3 / 5

Distinctiveness Conflict Risk

The Algorithmia platform name creates a clear niche with minimal wrong-skill trigger risk, but the surrounding wording ("Manage data, records, and automate workflows") is generic enough to overlap with other data-management skills. Mostly distinct with minor overlap risk, matching anchor 4 rather than 5, whose distinct triggers carry the whole description.

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