CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

acelle-mail

Acelle Mail integration. Manage Users. Use when the user wants to interact with Acelle Mail 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/acelle-mail/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 skill delivers largely executable, well-organized CLI guidance for Acelle Mail, with a sensible connection setup flow. Its weaknesses are the missing validation around destructive/batch operations (deleting subscribers/lists, running campaigns), a broken step reference ("Step 2" never defined), inlined generic Membrane setup content, and some introductory padding.

Suggestions

Add explicit verification steps before destructive or batch operations — e.g., confirm the subscriber exists (find-subscriber-by-email) before delete-subscriber, and verify campaign content/statistics via get-campaign before run-campaign — which would lift workflow_clarity above its current cap of 3.

Fix the broken navigation: "skip to **Step 2**" points at no heading; either number the sections (Step 1, 1b, 2, ...) or replace the reference with the actual section name.

Trim the opening background paragraph and filler lines ("Use action names and parameters as needed.") and move the generic Membrane CLI install/login/proxy material into a shared reference file, keeping SKILL.md focused on Acelle Mail specifics.

DimensionReasoningScore

Conciseness

The body opens with background Claude does not need ("Acelle Mail is a self-hosted email marketing application, similar to MailChimp... It's used by businesses and individuals..."), includes filler ("Use action names and parameters as needed.") and commentary ("so you can focus on the integration logic rather than auth plumbing"), though most of the body is functional commands and tables. This sits at 'mostly efficient but includes some unnecessary explanation', above anchor 2 (which would require heavily padded prose) but not the 'minor instances' of anchor 4.

3 / 5

Actionability

Commands are concrete and executable throughout ("npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://acellemail.com/\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json", plus the proxy flag table). However placeholders like CONNECTION_ID, <actionId>, and /path/to/endpoint are never resolved into a worked end-to-end example with real values, so it falls short of the copy-paste-ready anchor 5 while clearly exceeding the pseudocode-level anchor 3.

4 / 5

Workflow Clarity

The sequence (install → login → connection ensure → poll for READY → search actions → run) is present with state-branching and polling checkpoints, but destructive and batch operations ("Delete List", "Delete Subscriber", "Run Campaign" launching bulk email sends) have no validation or verification steps, capping this dimension at 3 per the rubric guideline. Additionally, "If the returned connection has `state: \"READY\"`, skip to **Step 2**" references a heading that does not exist, leaving the numbered flow broken.

3 / 5

Progressive Disclosure

Sections are reasonably organized with headers and tables, but the generic Membrane CLI material (install, login, connection lifecycle states, proxy flag reference) is inline content that belongs in a separate shared reference file, and no bundle files or references exist at all. This matches 'some structure but could be better organized; content that should be separate is inline', above anchor 2 because structure is genuinely present.

3 / 5

Total

13

/

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 trigger clause and a distinctive product name, but it severely undersells the skill's actual capabilities: 'Manage Users' is both vague and unrepresentative of the campaign/subscriber/mail-list functionality the skill provides. Keyword coverage is limited to the product name, missing the email-marketing vocabulary users would naturally use.

Suggestions

Replace the vague "Manage Users" with the skill's real capabilities, e.g. "Manage Acelle Mail campaigns, subscribers, and mail lists" — this directly addresses the lowest-scoring dimension (specificity).

Add natural trigger terms users would say, such as "email marketing", "campaigns", "newsletters", or "subscribers", to broaden trigger_term_quality beyond the product name.

Make the 'when' clause concrete: "Use when the user wants to manage email campaigns, subscribers, or mail lists in Acelle Mail" instead of the generic "interact with Acelle Mail data".

DimensionReasoningScore

Specificity

It names the domain ("Acelle Mail integration") but the only action stated is the generic "Manage Users" — the skill's actual capabilities (campaigns, subscribers, mail lists, sending) are absent. This matches 'names the domain but actions are minimal or generic'; anchor 3 would require at least one or two concrete actions, and 'Manage Users' is not concrete.

2 / 5

Completeness

Both elements are present: a 'what' ("Acelle Mail integration. Manage Users.") and an explicit 'when' ("Use when the user wants to interact with Acelle Mail data"). It is not anchor 5 because the 'what' is vague and the 'when' lacks concrete trigger phrases; it is above anchor 3 because the 'Use when' clause is explicitly stated rather than missing or implied.

4 / 5

Trigger Term Quality

"Acelle Mail" is a strong, specific keyword users of the product would say, but the description misses the natural variations and synonyms — email marketing, campaigns, newsletters, subscribers, mail lists, bulk email — leaving keyword coverage partial. This matches 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"Acelle Mail" carves a clear niche with minimal chance of firing for unrelated skills, but the generic "Manage Users" phrasing creates minor overlap risk with generic user-management or admin skills. This matches 'mostly distinct; minor overlap risk' — anchor 5 would drop the generic user-management framing entirely.

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/acelle-mail/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.