CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ably

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

Quality

65%

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/ably/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 is a strong, command-driven integration guide: every step is executable, the connection state machine is handled with explicit error-recovery guidance, and discovery via the action catalog is well supported. Weaknesses are modest: a redundant intro paragraph explaining what Ably is, a broken 'Step 2' cross-reference, and inconsistent CLI invocation (npx vs membrane).

Suggestions

Remove or shrink the opening 'Ably is a realtime data delivery platform...' paragraph and the near-empty 'Ably Overview' section — Claude already knows what Ably is.

Fix the dangling 'skip to Step 2' reference (there is no Step 2 heading) and use one consistent CLI invocation ('membrane' vs 'npx @membranehq/cli').

Move the 18-row 'Popular actions' catalog and the proxy flag table into a references/ file to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

The opening paragraph 'Ably is a realtime data delivery platform. Developers use it to build live and collaborative experiences' explains a concept Claude already knows, and lines like 'This will either open a browser for authentication...' could be tightened. The remainder is mostly efficient command-plus-brief-explanation prose, matching the 'mostly efficient but includes some unnecessary explanation' anchor rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Commands are fully executable and copy-paste ready throughout: 'membrane connection ensure "https://ably.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input \'{"key": "value"}\' --json', a complete 18-action catalog with keys, and a full proxy flag table. This matches the anchor for fully executable, copy-paste ready commands covering common cases; anchor 4 would require minor gaps, which are absent.

5 / 5

Workflow Clarity

There is a clear install → login → connect → poll → discover → run sequence with explicit state-based checkpoints ('READY', 'CLIENT_ACTION_REQUIRED' → show uiUrl then re-poll, 'CONFIGURATION_ERROR' → check error field), which is genuine error-recovery guidance. It falls short of anchor 5 due to a dangling 'skip to Step 2' reference with no Step 2 heading and an inconsistent invocation ('npx @membranehq/cli connection get' vs 'membrane connection get').

4 / 5

Progressive Disclosure

The body has good structure with clear section headers, a table of contents-like 'Ably Overview', and well-organized action and flag tables, and no bundle files exist so nothing is misfiled. It is not anchor 5 because the 18-row action catalog and CLI reference are inline API-reference material that could be split into a references file for a leaner SKILL.md, though this is a minor organization gap rather than the inlined-wall-of-text problem of anchor 3.

4 / 5

Total

16

/

20

Passed

Description

41%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 Ably domain and includes a 'Use when' trigger clause, but its capability statement is generic buzzword-level ('manage data, records, automate workflows') with no concrete Ably actions and no natural trigger terms beyond the brand name. It would benefit most from enumerating real capabilities (channels, messages, presence, tokens, push notifications) that double as trigger keywords.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Ably actions, e.g. 'Publish messages to channels, request auth tokens, view presence and message history, manage push notification devices and subscriptions, and read app stats.'

Add natural trigger terms to the 'Use when' clause: 'Use when the user mentions Ably, realtime messaging, channels, pub/sub, presence, or push notifications.'

Drop the vague 'Manage data, records' phrasing entirely — 'records' is not an Ably concept and it blurs distinctiveness against generic data-management skills.

DimensionReasoningScore

Specificity

The description names the domain ('Ably integration') but its actions — 'Manage data, records, and automate workflows' — are generic with no concrete Ably operations (channels, messages, tokens, presence, push), matching anchor 2 ('Names the domain but actions are minimal or generic'). It is not anchor 3 because no 1-2 concrete actions are actually listed, and not anchor 1 because the domain is explicitly named.

2 / 5

Completeness

The 'Use when the user wants to interact with Ably data' clause provides an explicit trigger, but the 'what' — 'Manage data, records, and automate workflows' — is vague, sitting between anchor 3 (clear what, weak when) and anchor 4 (both present, when could be more explicit). Because the what is no clearer than the when, it lands below anchor 4's standard of 'Extract text from PDFs and fill forms. Use when working with PDF files.'

3 / 5

Trigger Term Quality

The only natural trigger keyword is the brand name 'Ably'; terms users would actually say for this skill — realtime, channels, publish/subscribe, messages, presence, push notifications, tokens — are all missing. This matches anchor 2 ('one or two generic keywords; missing the natural phrases users say') rather than anchor 3, which requires several relevant Ably-specific keywords.

2 / 5

Distinctiveness Conflict Risk

'Ably' is a distinct brand-name trigger giving this a clear niche with minimal conflict risk against other skills, matching anchor 4 ('mostly distinct; minor overlap risk'). It is not anchor 5 because the trailing 'Manage data, records, and automate workflows' phrasing could pull triggers from generic data/automation skills when Ably is not mentioned.

4 / 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/ably/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.