CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clari

Clari integration. Manage data, records, and automate workflows. Use when the user wants to interact with Clari 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/clari/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 is genuinely actionable — executable CLI commands with flags, a state-machine walkthrough for connection setup, and concrete error-handling guidance — held back by dead weight and loose structure. The placeholder 'Clari Overview', the duplicated action-discovery command, the dangling 'Step 2' reference, and the absence of any reference files for the bulkier detail (proxy flags, clientAction schema) are the main fixable gaps.

Suggestions

Delete the placeholder 'Clari Overview' bullet list and the duplicated 'Popular actions' section (it repeats the 'Searching for actions' command); replace the former with a short mapping of Clari entities (Opportunity, Account, User, Activity) to example action names, and the latter with 5-10 concrete popular actions with their IDs.

Fix the broken step numbering: either label the sections 'Step 1: Connect', 'Step 2: Find actions', 'Step 3: Run actions' so 'skip to Step 2' resolves, or drop the numbered references entirely.

Move the proxy flag table and the clientAction field schema into a reference file (e.g. references/proxy.md) with a clearly signaled link, keeping SKILL.md as a lean overview — this also addresses the duplicated install of detail that inflates the body.

DimensionReasoningScore

Conciseness

The body is mostly command-plus-one-line-explanation, but it carries clear waste: the marketing-style opener ('helps sales, marketing, and customer success teams improve their forecasting...'), a 'Clari Overview' section that is an empty placeholder bullet list ('Opportunity / User / Activity / Account / User / User' plus 'Use action names and parameters as needed.'), and a 'Popular actions' section that duplicates the 'Searching for actions' command verbatim. Anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') fits; the duplicated and dead sections rule out 4.

3 / 5

Actionability

Nearly every section gives copy-paste-ready commands: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://clari.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input \'{"key": "value"}\' --json', plus a concrete proxy flag table. Minor gaps keep it at anchor 4 rather than 5: 'membrane login --tenant --clientName=<agentType>' shows --tenant with no value, and the 'Popular actions' heading promises actions but only repeats the discovery command instead of naming any.

4 / 5

Workflow Clarity

The connection flow has real checkpoints and a feedback loop — poll with '--wait', branch on 'READY' / 'CLIENT_ACTION_REQUIRED' (with the clientAction type, uiUrl, and agentInstructions fields explained) / 'CONFIGURATION_ERROR' or 'SETUP_FAILED', then re-poll after the user acts — matching anchor 4's 'clear sequence with most checkpoints present'. Not 5 (and not the simple-skill exception) because the sequence is partially incoherent: 'skip to Step 2' points at a step that is never labeled, and the lone '#### 1b' heading references a numbering scheme (1a/2) that doesn't exist.

4 / 5

Progressive Disclosure

There are no bundle files at all — references/, scripts/, and assets/ do not exist — and all content (install, auth, connection lifecycle, clientAction schema walkthrough, proxy flag table) is inline in a single ~140-line file with usable headers. Anchor 3 ('some structure but could be better organized; content that should be separate is inline') fits: the proxy flag table and clientAction field details are natural candidates for one-level-deep reference files. The under-50-line exception does not apply, ruling out 5; decent sectioning rules out 2.

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 has the right skeleton — a named domain and an explicit 'Use when' clause — but the capability statement is boilerplate ('manage data, records, and automate workflows') that could describe almost any SaaS integration. Naming Clari's actual objects (opportunities, accounts, forecasts) would sharpen both what it does and when it fires.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Clari capabilities, e.g. 'Query and update opportunities, accounts, and activities, and pull forecast and revenue metrics'.

Add natural trigger terms users would actually say — 'forecast', 'pipeline', 'revenue', 'sales operations' — to the 'Use when' clause, e.g. 'Use when the user mentions Clari, forecasts, pipeline, or revenue data'.

State the interaction mode (run pre-built actions or make raw API calls via the Membrane proxy) so the what is distinguishable from generic record-management skills.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain (Clari) but the actions are entirely generic — no concrete operation is stated (create/update/query which records, which workflows). 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

It has both an explicit what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Clari data"), matching anchor 4. Not 5 because the 'when' merely restates the 'what' without concrete trigger phrases; the explicit 'Use when' clause rules out 3.

4 / 5

Trigger Term Quality

"Clari" and "interact with Clari data" cover the natural keyword a user would say, but all other terms ("data", "records", "workflows") are generic and common domain phrases like forecast, pipeline, revenue, opportunities, or accounts are missing — anchor 3 ('some relevant keywords but missing common variations or synonyms'). Not 4 because coverage beyond the app name is thin.

3 / 5

Distinctiveness Conflict Risk

The niche is clear — triggers hinge on "Clari", a distinctive app name — but the generic middle clause "Manage data, records, and automate workflows" creates minor overlap risk with other record/data-management skills, matching anchor 4 ('mostly distinct; minor overlap risk') rather than 5's fully distinct triggers.

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