CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bigmailer

BigMailer integration. Manage data, records, and automate workflows. Use when the user wants to interact with BigMailer 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/bigmailer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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.

A strong, execution-focused skill: nearly every instruction is a runnable membrane command, and the connection state-machine (READY / CLIENT_ACTION_REQUIRED / error states with polling) is handled unusually well. The main flaws are a dangling "Step 2" reference, missing verification guidance after running data-modifying actions, and a marketing-style opening paragraph that spends tokens on nothing operational.

Suggestions

Label the workflow steps explicitly (Step 1: connect, Step 2: search actions, Step 3: run) so the existing "skip to Step 2" reference resolves.

Add a verification checkpoint after running data-modifying actions (e.g. re-run `get-contact` or check the `output` and error fields before reporting success), since the skill covers create/update operations.

Trim the BigMailer marketing paragraph to one factual sentence and spend the tokens on the workflow instead.

DimensionReasoningScore

Conciseness

The body is dominated by copy-paste commands, tables, and state-machine guidance with very little padding. The one trimmable section is the opening paragraph ("It's used by companies looking for a cost-effective solution... It caters to users who want more control over their email infrastructure") — marketing context Claude doesn't need — which keeps it at anchor 4 rather than 5.

4 / 5

Actionability

Every stage has a complete, runnable command: install, login (including headless completion via `membrane login complete <code>`), `connection ensure`, polling with `--wait`, `action list --intent`, `action run` with `--input` JSON, and proxy requests with a full flag table. These are copy-paste ready and cover the common cases (score 5 anchor); nothing is pseudocode.

5 / 5

Workflow Clarity

A real sequence exists (install → login → connect → poll states → search actions → run → proxy fallback) with good connection-state checkpoints, but two gaps hold it at anchor 3: the text says "skip to **Step 2**" yet no Step 2 is ever labeled, and the run-actions flow has no verification step for data-modifying operations (create/update contact) — the rubric caps workflow clarity at 3 when destructive/batch operations lack validation. It is above anchor 2 because the sequence and the connection polling/error-state feedback are explicit and concrete.

3 / 5

Progressive Disclosure

The single file is well organized with clear sections (overview, install, auth, connect, actions, proxy, best practices) and tables that are easy to navigate, and there are no buried or nested references. It is not anchor 5 because the 20-row actions table and proxy flag reference are candidates for a separate reference file in a larger bundle, though at this size keeping them inline is a minor issue, not the inlining problem of anchor 3.

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 has the right structure (domain + what + explicit 'Use when' trigger) but wastes it on generic filler: "Manage data, records, and automate workflows" describes no BigMailer-specific capability and omits all email-marketing vocabulary (campaigns, contacts, mailing lists, senders) that users would actually say. It reads like a template placeholder rather than a description written for this app.

Suggestions

Replace the generic middle sentence with BigMailer-specific capabilities, e.g. "Manage contacts and mailing lists, create and monitor bulk and transactional email campaigns, segments, custom fields, and verified senders."

Add email-marketing trigger terms to the 'Use when' clause — e.g. "Use when the user wants to work with BigMailer email campaigns, contacts, subscribers, mailing lists, or segments" — so it triggers on natural user phrasing, not just the product name.

Drop the vague "automate workflows" buzzword; it adds no signal and conflicts with generic automation skills.

DimensionReasoningScore

Specificity

The description names the domain ("BigMailer integration") but the actions are generic — "Manage data, records, and automate workflows" could apply to almost any data platform; no concrete actions like send campaigns, manage contacts, or create mailing lists. It fits anchor 2 ('names the domain but actions are minimal or generic') better than anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both parts are present: a what ("BigMailer integration. Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with BigMailer data"). It is not anchor 5 because the 'what' side lacks concrete trigger phrases (what kind of BigMailer tasks — campaigns, contacts, senders), and not anchor 3 because the 'when' is explicit, not weakly implied.

4 / 5

Trigger Term Quality

"BigMailer" is the key natural term and "data", "records", "workflows" are relevant, but the description omits the most common user phrasings for an email marketing platform: "email", "campaign", "contacts", "mailing lists", "segments". Some relevant keywords but missing common variations and synonyms (anchor 3); not anchor 2 since the product name itself is a strong natural keyword, not anchor 4 since the email-domain vocabulary is entirely absent.

3 / 5

Distinctiveness Conflict Risk

The BigMailer product name and "Use when the user wants to interact with BigMailer data" anchor the trigger to a distinct niche, so wrong-skill triggering is unlikely. It is not anchor 5 because the leading capability sentence ("Manage data, records, and automate workflows") is generic and would overlap with any data-management skill if read alone.

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