CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aimtell

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

Quality

61%

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

Quality

Content

56%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 delivers strong operational guidance — real CLI commands, a well-documented connection state machine with polling feedback loops, and a sensible action-discovery-before-proxy workflow. Its weaknesses are token waste (a marketing-style platform intro and a 20-row table of 'No description' entries), a dangling 'Step 2' reference, and no progressive disclosure into reference files.

Suggestions

Delete or compress the introductory paragraph explaining what Aimtell and push notifications are, and trim the 'Popular actions' table to a representative subset or a short key list — 20 rows of 'No description' add tokens without guidance.

Fix the dangling references: 'skip to Step 2' appears twice but no Step 2 is labeled; number the workflow stages consistently.

Move the full action listing and proxy flag reference into a references/ file (e.g. ACTIONS.md), keeping SKILL.md as a lean overview with one-level-deep links.

DimensionReasoningScore

Conciseness

The intro paragraph explains what Aimtell and push notifications are ("Aimtell is a web push notification platform that allows businesses to send targeted messages... Think of it as a way to send notifications directly to a user's desktop"), a concept Claude does not need explained, and the 20-row 'Popular actions' table repeats "No description" on every row, adding zero information beyond names. These are several padded sections (also the garbled agent-types aside), matching anchor 2 rather than 3's 'some unnecessary explanation'.

2 / 5

Actionability

Concrete, executable commands throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://aimtell.com/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json', plus a full proxy flag table. It stops short of anchor 5 because commands contain unresolved placeholders (CONNECTION_ID, QUERY, <actionId>) and no worked example with real values.

4 / 5

Workflow Clarity

A clear sequence exists (install → login → connection ensure → poll for READY → resolve clientAction → search actions → run → proxy fallback) with explicit checkpoints (poll until state leaves BUILDING, check the error field on CONFIGURATION_ERROR, re-poll after user action). Anchor 5 is not reached due to minor gaps: 'skip to Step 2' is referenced twice but no Step 2 exists, and there is no verification of action output.

4 / 5

Progressive Disclosure

The document is well-sectioned with clear headers, but it is a ~175-line self-contained file with no bundle files; content that would serve better in a reference file (the 20-row action listing, the proxy flag table) is inlined. Anchor 3 ('content that should be separate is inline') fits; not 2 because the sections are well-organized and navigable, and not 4 because there is no separation of overview from detail at all.

3 / 5

Total

13

/

20

Passed

Description

48%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 uses third person and includes a 'Use when...' clause, but its substance is thin: the app name does the triggering work while the capability and trigger language is generic and circular. It would rarely misfire, but it also fails to convey what the skill concretely does with Aimtell.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Aimtell capabilities, e.g. 'Create and send push notification campaigns, manage segments and subscribers, and retrieve website analytics'.

Expand the 'when' clause with natural task triggers: 'Use when the user mentions Aimtell, push notifications, web push campaigns, subscriber segments, or opt-in prompts'.

Add the terms users actually say (push notifications, campaigns, subscribers, segments) so the description triggers on task language, not only the brand name.

DimensionReasoningScore

Specificity

"Aimtell integration. Manage data, records, and automate workflows" names the domain but the actions are entirely generic — no concrete capabilities like sending push notifications, creating campaigns, or managing subscribers. This matches anchor 2 ('Names the domain but actions are minimal or generic') rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both a 'what' ("Manage data, records, and automate workflows") and a 'when' ("Use when the user wants to interact with Aimtell data") are present, but the 'what' is vague and the 'when' is circular, restating the app name rather than giving concrete triggers. It falls between anchor 3 and 4, noticeably below anchor 4's bar of a concrete 'what' paired with an explicit 'when'.

3 / 5

Trigger Term Quality

"Aimtell" is a specific, natural keyword a user would say, but the only other terms ("data", "records", "workflows") are generic; common task phrases like push notifications, campaigns, subscribers, or segments are missing. Anchor 3 ('Some relevant keywords but missing common variations or synonyms') fits better than 4, which requires good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The app name "Aimtell" establishes a clear niche and primary trigger, making wrong-skill triggering unlikely, but the surrounding generic phrasing ("Manage data, records, and automate workflows") could overlap with other data-integration skills. Anchor 4 ('Mostly distinct; minor overlap risk') fits; anchor 5 would require distinct trigger phrases beyond the app name.

4 / 5

Total

12

/

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