CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clarify

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

Quality

Content

75%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, command-first CLI guide: nearly every instruction is an executable command, the connection lifecycle is handled with explicit state checkpoints and recovery paths, and there is almost no padding or explanation of concepts Claude already knows. The main defects are small but real — broken cross-references to a nonexistent 'Step 2' and unlabeled step '1b', a duplicated action-list command, and a login invocation with an unresolved `--tenant` placeholder.

Suggestions

Fix the internal navigation: either create a labeled "Step 2" section (e.g. Searching for actions) or remove the two "Skip to **Step 2**" references and rename "1b" to something coherent like "Wait for the connection to be ready".

Merge "Popular actions" into "Searching for actions" — it currently restates the same `action list --intent=QUERY` command with no added content.

Complete the login example: show what `--tenant` expects (e.g. `--tenant=<tenant-id>`) and link the `--clientName` value to the Agent Types list so the command is truly copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dominated by lean, executable commands with minimal concept explanation — it assumes competence rather than teaching CLI basics. Minor trimming is possible: the action-list command appears twice ("Searching for actions" and "Popular actions"), and asides like "This is the fastest way to get a connection" plus the vague "Agent Types" line add mild padding — so anchor 4 ('efficient; minor instances that could be trimmed'), not 5.

4 / 5

Actionability

Nearly everything is copy-paste ready: `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://www.clarify.io/" --json`, `membrane action run <actionId> --input '{...}' --json`, plus a concrete proxy flags table. Not 5 because of small gaps: "Skip to **Step 2**" points to a section that doesn't exist, and `membrane login --tenant --clientName=<agentType>` leaves `--tenant` without a value or placeholder explanation.

4 / 5

Workflow Clarity

The install → login → connect → poll → search → run flow is clearly sequenced with explicit state-based checkpoints (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a re-poll loop after user action — genuine error-recovery feedback. Not 5 because the section numbering is incoherent ("1b" with no labeled Step 1, and two references to a nonexistent "Step 2"), which leaves a navigation gap in the sequence.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with no references/, scripts/, or assets/ bundle, and the body contains no dangling references to bundle files. Sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) are well organized and appropriately sized for one level. Not 5 because at ~145 lines the proxy flag table and connection-state reference sit inline where a split into a reference file would keep the overview tighter.

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 an explicit and correctly-framed 'Use when...' trigger clause anchored by the distinct product name Clarify, but everything beyond that name is generic. Action words like 'manage data, records, and automate workflows' could apply to almost any data tool, and domain-specific vocabulary (support tickets, conversations, tasks) that users of a customer-support platform would actually say is entirely absent.

Suggestions

Replace generic actions with Clarify-specific ones: e.g. 'Manage customer conversations, tasks, and records; run and automate Clarify workflows' — list 2-3 concrete operations the skill performs.

Broaden trigger terms to include the natural vocabulary of the platform's users: 'customer support', 'support tickets', 'conversations', 'workflow automation', not just 'Clarify data'.

Align the description with the body's actual capability surface (discover and run actions, proxy raw API requests) so the 'what' reflects what the skill really does.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain (Clarify) but the actions are generic — no concrete operations like managing conversations, tasks, or support tickets are listed. It fits anchor 2 ('names the domain but actions are minimal or generic') rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both are explicitly present: a what ("Manage data, records, and automate workflows") and a when ("Use when the user wants to interact with Clarify data"). Not 5 because the 'what' lacks concrete trigger-worthy actions and the 'when' is a single generic clause; not 3 because the 'Use when...' clause is explicit, avoiding the anchor-3 condition of a missing/weakly-implied 'when'.

4 / 5

Trigger Term Quality

"Clarify" and "Clarify data" are relevant keywords a user would say, but common variations users actually use — "customer support", "tickets", "conversations", "helpdesk" — are all missing. Fits anchor 3 ('some relevant keywords but missing common variations or synonyms'), not 4 which requires good broader coverage.

3 / 5

Distinctiveness Conflict Risk

The proper noun "Clarify" gives it a clear niche with minimal conflict risk when users mention the app. Not 5 because the generic tail "Manage data, records, and automate workflows" could overlap with other data-management or automation skills when 'Clarify' is absent; not 3 because the app name anchors it far better than 'somewhat specific'.

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