CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

assertible

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

Quality

67%

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

Quality

Content

63%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, executable Membrane CLI guidance with an unusually well-handled connection state machine (polling, client actions, error states), making it genuinely actionable. Its weaknesses are structural: a padded overview list, an empty duplicated 'Popular actions' section, broken step numbering ('Step 2' never defined), and inconsistent command invocation. Tightening the organization and adding one worked Assertible example would lift it substantially.

Suggestions

Fix the workflow numbering: the body references 'skip to Step 2' and has a '1b' subsection but no Step 1/1a/2 labels — number the main steps (install, authenticate, connect, discover, run) explicitly.

Remove the empty 'Popular actions' section (it duplicates the 'Searching for actions' command) and replace it with 2-3 concrete example actions, e.g. 'membrane action run <test-run-action-id> --connectionId=... --input '{"testId": "..."}''.

Cut the bare 'Assertible Overview' bullet taxonomy (it adds no actionable guidance) and standardize on one invocation form ('membrane' vs 'npx @membranehq/cli@latest') to avoid confusion.

DimensionReasoningScore

Conciseness

The body is mostly command-focused, but the bare 'Assertible Overview' bullet taxonomy adds no actionable content, the 'Popular actions' section is a near-empty duplicate of 'Searching for actions' (repeating 'action list --intent=QUERY'), and command invocation is inconsistent ('membrane' vs 'npx @membranehq/cli'). Mostly efficient with some unnecessary sections (anchor 3); not 4 because of this padding, and not 2 because the bulk of the body is concrete commands.

3 / 5

Actionability

Concrete, copy-paste-ready commands appear throughout ('membrane connection ensure "https://assertible.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input ... --json') plus a proxy flags table. Mostly executable (anchor 4); not 5 because 'Popular actions' promises examples but delivers none, no actual Assertible action names are shown, and invocation style varies between 'membrane' and 'npx @membranehq/cli'.

4 / 5

Workflow Clarity

A clear sequence is present (install → login → connection ensure → poll until READY → discover actions → run/proxy) with explicit checkpoints: a long-poll loop on connection state, CLIENT_ACTION_REQUIRED handling with uiUrl, and error-state guidance ('CONFIGURATION_ERROR or SETUP_FAILED — check the error field'). Not 5 because the text says 'skip to Step 2' but no Step 2 is labeled (only a dangling '1b' subsection) and there is no validation guidance for action-run results; not 3 because state-machine checkpoints and recovery steps are explicit.

4 / 5

Progressive Disclosure

This is a single-file skill (no references/, scripts/, or assets/ exist and none are referenced) with reasonable headers, but organization has real gaps: an empty 'Popular actions' section, broken step numbering ('skip to Step 2' with no Step 2, a '1b' with no '1a'), and a duplicated discovery command. Fits anchor 3 ('some structure but could be better organized'); not 4 because of these structural defects, and not 2 because the content is not a monolithic wall and placement is reasonable for a single file.

3 / 5

Total

14

/

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 correctly names the target app and includes an explicit 'Use when' clause, but it mischaracterizes Assertible as generic data/records/workflow management rather than its actual purpose (API testing and monitoring). The generic action phrasing weakens specificity and trigger-term coverage, since users asking for API testing or monitoring help would not naturally trigger this skill.

Suggestions

Replace the generic action phrase 'Manage data, records, and automate workflows' with concrete Assertible capabilities, e.g. 'Run API tests, check assertions, and monitor web service reliability'.

Add functional trigger terms to the 'Use when' clause so users asking for API validation trigger the skill, e.g. 'Use when the user wants to test APIs, run API tests, validate endpoints, or monitor web service uptime with Assertible'.

Mention the domain vocabulary (API testing, assertions, deployments, schedules) somewhere in the description to distinguish it from generic data-management skills.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Assertible domain but the actions are entirely generic; no concrete capabilities (API tests, assertions, monitoring) are stated. This matches anchor 2 ('names the domain but actions are minimal or generic'), not 3, because not even 1-2 concrete actions are listed.

2 / 5

Completeness

Both parts are explicit: the what ("Assertible integration. Manage data, records, and automate workflows") and the when ("Use when the user wants to interact with Assertible data"). Matches anchor 4 ('has both what and when; when could be more explicit or specific'); not 5 because the when is generic and no concrete trigger phrases are given, and not 3 because the 'Use when' clause is explicitly present rather than missing or implied.

4 / 5

Trigger Term Quality

"Assertible" is the relevant, app-specific keyword, but all natural functional phrases users would say ("API testing", "test my endpoint", "monitoring", "assertions") are missing. Fits anchor 3 ('some relevant keywords but missing common variations or synonyms'); not 4 because the entire functional vocabulary is absent, and not 2 because the primary trigger term is present and specific.

3 / 5

Distinctiveness Conflict Risk

The "Assertible" branding establishes a clear niche trigger, but "Manage data, records, and automate workflows" is generic phrasing that overlaps with data-management and automation skills. Mostly distinct with minor overlap risk (anchor 4); not 5 due to the generic overlap, and not 3 because the app-specific trigger clearly dominates.

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