CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

active-trail

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

Quality

71%

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/active-trail/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 highly actionable — concrete CLI commands, a complete actions table, and proxy guidance make it immediately usable — with a solid connection-state feedback loop. Its weaknesses are the marketing-fluff intro and bare feature list, the dangling 'Step 2' reference, and the absence of any validation/confirmation guidance for destructive delete operations.

Suggestions

Cut the 'Active Trail is an email marketing automation platform...' paragraph and the 'Active Trail Overview' feature bullet list — Claude doesn't need this background to operate the API (conciseness, currently score 3).

Add explicit verification before destructive actions, e.g. 'Before delete-contact/delete-mailing-list/delete-group, run the corresponding get action and confirm the target with the user' (workflow_clarity, currently capped at 3 by the missing-validation rule).

Fix the dangling 'skip to **Step 2**' references by labeling the Searching/Running sections as numbered steps, and consider moving the popular-actions table into a references file for a leaner SKILL.md (progressive_disclosure, currently score 4).

DimensionReasoningScore

Conciseness

The bulk of the body is efficient — commands, flag tables, and an actions table with no padding — but it opens with explanations Claude doesn't need: 'Active Trail is an email marketing automation platform... It's used by marketing teams and small business owners to engage with customers and grow their business' plus a bare feature bullet list ('Contacts', 'Campaigns', 'Reports'...) that adds no actionable guidance. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened'); it is not anchor 2 because the padding is confined to two short sections rather than being pervasive.

3 / 5

Actionability

The guidance is fully executable: copy-paste-ready CLI commands for install ('npm install -g @membranehq/cli@latest'), login, connection setup ('membrane connection ensure "https://activetrail.com/" --json'), action search/run with JSON input examples, a proxy options flag table, and a 19-row actions table with exact keys covering the common cases (list/get/create/update/delete for contacts, lists, campaigns, groups). This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The setup-to-execution sequence is present with a genuine polling feedback loop for connection states (BUILDING → CLIENT_ACTION_REQUIRED → poll again after user action), but it has validation gaps: the text says 'skip to **Step 2**' yet no Step 2 is ever labeled, CONFIGURATION_ERROR handling is just 'check the error field', and the destructive actions in the table (delete-contact, delete-mailing-list, delete-group) have no verification or confirmation guidance. Per the rubric's cap for destructive/batch operations without validation, workflow clarity cannot exceed 3.

3 / 5

Progressive Disclosure

The skill has no bundle files, and the single body is well-organized with clear section headers (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) placing content appropriately; only the popular-actions table and proxy flag reference approach the size that could live in a separate file. This fits anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps') — not anchor 5 since at ~165 lines it exceeds the simple-skill threshold and could split the actions/proxy reference material into a references file.

4 / 5

Total

15

/

20

Passed

Description

61%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 is safe on distinctiveness thanks to the named product, and it correctly includes an explicit 'Use when' clause, but it undersells the skill's actual capabilities with generic verbs ('manage data, records'). Replacing the abstract language with 2-3 concrete Active Trail operations would lift both specificity and trigger coverage.

Suggestions

Replace generic actions with concrete ones, e.g. 'Create and manage contacts, mailing lists, campaigns, and automations in Active Trail' (specificity, currently score 2).

Add natural trigger terms users would say — 'email campaign', 'contacts', 'mailing list', 'marketing automation', 'SMS' — to the 'Use when' clause (trigger_term_quality, currently score 3).

Broaden the 'when' clause beyond 'interact with Active Trail data' to cover campaign creation, contact management, and automation workflows (completeness, currently score 4).

DimensionReasoningScore

Specificity

The description names the domain ("Active Trail integration") but the actions are generic: "Manage data, records, and automate workflows" uses abstract verbs with no concrete operations like creating campaigns, listing contacts, or sending emails. It matches anchor 2 ('Names the domain but actions are minimal or generic') and falls short of anchor 3, which requires 1-2 concrete actions — none of the stated actions are specific to Active Trail's capabilities.

2 / 5

Completeness

Both parts are present: the 'what' ("Manage data, records, and automate workflows") and an explicit 'when' clause ("Use when the user wants to interact with Active Trail data"). It matches anchor 4 ('Has both what and when; when could be more explicit or specific') because the 'when' is narrow — it covers only 'interacting with data' and misses triggers like creating campaigns or automations — and the 'what' is stated generically rather than with concrete trigger phrases as anchor 5 requires.

4 / 5

Trigger Term Quality

The key natural term "Active Trail" is present and would be said by users needing this skill, but generic terms ("data", "records", "workflows") substitute for the common phrases users would actually use — no mention of email campaigns, contacts, mailing lists, SMS, or marketing automation. This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms').

3 / 5

Distinctiveness Conflict Risk

The description leads with the specific product name "Active Trail" and its trigger centers on that name, giving it a clear niche with minimal conflict risk against other skills — matching anchor 5. It is not merely 'mostly distinct' (anchor 4) because no other plausible skill would claim Active Trail triggers.

5 / 5

Total

14

/

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/active-trail/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.