CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

algomo

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

Quality

69%

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

Quality

Content

68%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 concise, actionable CLI cookbook: executable commands for setup, connection, discovery, execution, and proxying, with sensible best-practice guidance at the end. Its main gap is workflow validation — there are no checkpoints or error-recovery loops for the login→connect→run sequence — and minor organization/actionability gaps (an unexplained entity list, no worked example for the one listed action).

Suggestions

Add verification checkpoints to the workflow, e.g. after login run a cheap check like "membrane connection list --json" to confirm auth succeeded before connecting, and note how to recover when a connect or action run fails.

Fold "Getting list of existing connections" into "Connecting to Algomo" as step 0 (check for an existing connection before creating one), so the connection workflow is one coherent numbered sequence.

Add a worked example for the flagship action, e.g. an actual "membrane action run --connectionId=... get-bot-response --input" invocation with realistic values, since the Popular actions table lists it but never shows how to call it.

DimensionReasoningScore

Conciseness

The body is command-first and mostly lean — install, login, connect, search, run, and proxy sections are each a few lines with executable commands — with only minor trimmable commentary ("so you can focus on the integration logic rather than auth plumbing", "This will burn less tokens and make communication more secure"). This matches "Efficient; minor instances of over-explanation that could be trimmed" rather than anchor 5, and is well above the verbose anchors.

4 / 5

Actionability

Guidance is mostly executable: copy-paste commands such as "npm install -g @membranehq/cli", "membrane login --tenant", "membrane connect --connectorId=CONNECTOR_ID --json", and "membrane request CONNECTION_ID /path/to/endpoint", with key placeholders explained ("Take the connector ID from output.items[0].element?.id"). Minor gaps keep it at 4 rather than 5: the single listed action (get-bot-response) has no worked example with real input values, and the proxy path and ACTION_ID remain unsubstituted placeholders.

4 / 5

Workflow Clarity

The sequence is clear and well-ordered (install → login with headless variant → check/create connection → search actions → run or proxy), and one explicit checkpoint exists ("When you are not sure if connection already exists ... membrane connection list"). But validation is otherwise missing or implicit — no step verifies login succeeded, no guidance on handling a failed connect or action error — matching "Steps listed but validation gaps; sequence present but checkpoints missing or implicit" rather than anchor 4's "most checkpoints present".

3 / 5

Progressive Disclosure

The skill is a single well-sectioned file (~110 lines) with no bundle files and no local references; everything present is reasonably placed inline and the only external pointer (official docs) is clearly signaled, so navigation is easy. It fits "Good structure; most content is appropriately placed; minor organization gaps" — e.g. the bare "Algomo Overview" entity list adds little, and the standalone "Getting list of existing connections" section could fold into "Connecting to Algomo" — rather than a fully clean 5.

4 / 5

Total

15

/

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 has an explicit "Use when" trigger and a distinctive brand name, giving it adequate completeness and low conflict risk. Its weakness is genericness: the stated capabilities ("Manage data, records, and automate workflows") are abstract boilerplate that neither describes what Algomo actually does (a customer communication/chatbot platform) nor surfaces its concrete actions, and the trigger vocabulary is limited to the brand name.

Suggestions

Replace the generic action list with concrete capabilities drawn from the actual integration, e.g. "Generate chatbot responses, manage Algomo datasets, records, and workspaces".

State what Algomo is in one clause (e.g. "customer communication platform") so the description matches users asking about chatbots or customer support, not only those who name the product.

Expand the when-clause with natural trigger variations, e.g. "Use when the user wants to interact with Algomo data, get bot responses, or manage Algomo datasets and workspaces".

DimensionReasoningScore

Specificity

The description names the domain ("Algomo integration") but its stated actions — "Manage data, records, and automate workflows" — are generic abstractions with no concrete capability (the body's actual action, "Generate a response from an Algomo chatbot", is never surfaced). It matches the anchor "Names the domain but actions are minimal or generic" rather than anchor 3, which requires at least one concrete action.

2 / 5

Completeness

Both parts are present: what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Algomo data"). It matches anchor 4 — the 'when' could be more specific — rather than 5, because neither the what nor the when includes concrete trigger phrases or specific capabilities.

4 / 5

Trigger Term Quality

"Algomo" is a strong, relevant keyword and "Use when the user wants to interact with Algomo data" gives an explicit trigger, but coverage beyond the brand name is thin — natural terms a user would say like chatbot, customer support, messaging, or bot response are absent. This matches "Some relevant keywords but missing common variations or synonyms"; it is not 4 because the natural-term coverage is essentially one brand term plus generic "data".

3 / 5

Distinctiveness Conflict Risk

The brand name "Algomo" in both the what and the when clause gives a clear niche and low wrong-skill risk, but "Manage data, records, and automate workflows" is generic boilerplate that mildly overlaps with any data-management skill. This fits "Mostly distinct; minor overlap risk" better than anchor 5, whose example shows multiple distinct concrete triggers.

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