CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clickhelp

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

Quality

65%

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

Quality

Content

57%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 a solid operational guide: nearly every section gives copy-pasteable Membrane commands, and connection lifecycle states are handled with concrete next-step guidance. Its main weaknesses are an incoherent 'skip to Step 2' cross-reference, no validation/confirmation guidance for destructive actions like delete-topic, a bulk actions table inlined rather than split into a reference file, and a few padded passages.

Suggestions

Fix the dangling cross-reference: the text says 'skip to **Step 2**' but no Step 2 section exists — either number the workflow steps consistently or replace the reference with the actual section name.

Add explicit verification guidance for destructive operations, e.g. confirm with the user before running delete-topic, and verify topic state after update-topic/publish-project before reporting success.

Move the 19-row actions table into a references/ file (e.g. references/actions.md) and keep only the most common actions inline; also trim filler lines like 'Use action names and parameters as needed.' and resolve the npx-vs-installed-CLI inconsistency.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, but several passages are padding: a two-sentence intro on who uses ClickHelp, the vacuous line 'Use action names and parameters as needed.', 'This is the fastest way to get a connection.', and a sloppy agent-types note ('Those will be used to adjust tooling to be used best with your harness'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is above 2 because unnecessary prose is the exception, not the rule, and below 4 because there are multiple trimmable passages.

3 / 5

Actionability

Commands are concrete and executable throughout: 'npm install -g @membranehq/cli@latest', 'membrane login complete <code>', 'membrane connection ensure "https://clickhelp.com/" --json', full connection-state handling, and a proxy flag table. It falls short of anchor 5 only in minor gaps: the parameter example is generic ('--input '{"key": "value"}'' rather than a real payload for a listed action) and the body mixes the installed CLI with 'npx @membranehq/cli'.

4 / 5

Workflow Clarity

The setup sequence (install → login → connect → poll state → search → run → proxy) is clear and includes state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but 'If the returned connection has state: "READY", skip to **Step 2**' references a section that does not exist, and destructive operations prominently listed in the actions table (delete-topic, update-topic) carry no validation or confirmation guidance — the rubric's cap for destructive/batch operations without verification applies. It is above anchor 2 because the sequence and state handling are well defined, and at 3 rather than 4 because of the dangling step reference and missing destructive-op checkpoints.

3 / 5

Progressive Disclosure

The body has good section headers but no bundle files exist and the 19-row 'Popular actions' table is bulk API-reference content inlined in a ~165-line SKILL.md — clearly matching anchor 3 ('content that should be separate is inline'). It is above 2 because the document is well structured and navigable, and below 4 because the action catalog and proxy reference material would be better split into a referenced file, especially given the 50-line simple-skill threshold is exceeded.

3 / 5

Total

13

/

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, giving it acceptable completeness and distinctiveness. Its weakness is genericness: the capability list ('manage data, records, automate workflows') reads as buzzwords with no ClickHelp-specific actions or natural synonyms (documentation, help content, topics, publications), which users would need to trigger it reliably.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete ClickHelp capabilities, e.g. 'Create and update help topics, manage projects and publications, export to PDF/Word, and administer users'.

Add natural trigger synonyms users would actually say: 'documentation', 'online help', 'user guides', 'knowledge base', 'help topics', 'publications' — not just the product name and 'data'.

Make the 'Use when' clause concrete rather than circular, e.g. 'Use when the user wants to author or manage documentation, publish a help portal, or search/edit ClickHelp topics'.

DimensionReasoningScore

Specificity

The description names the domain ("ClickHelp integration") but its actions are pure generic phrasing — "Manage data, records, and automate workflows" — with no ClickHelp-specific operations (topics, publications, TOC, users). It fits anchor 2 ('names the domain but actions are minimal or generic'), not 3, because no concrete capability like 'create topics' or 'publish projects' is stated.

2 / 5

Completeness

Both parts are explicitly present: the 'what' ("Manage data, records, and automate workflows") and an explicit 'when' clause ("Use when the user wants to interact with ClickHelp data"), so the missing-trigger cap of 3 does not apply. It does not reach 5 because neither part uses concrete trigger phrases — the 'when' is circular ('interact with ClickHelp data') and the 'what' is generic.

4 / 5

Trigger Term Quality

"ClickHelp" is a strong, natural keyword a user would actually say, but the description includes no synonyms or related phrases users might use instead — documentation, online help, user guide, knowledge base, topics, publications. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'); it is above 2 because the app name is more than a generic keyword, and below 4 because coverage beyond the product name is absent.

3 / 5

Distinctiveness Conflict Risk

Naming a niche application gives a clear, distinct trigger unlikely to fire for unrelated skills. However, the action language ("Manage data, records, and automate workflows") is entirely generic and overlaps with any data- or workflow-management skill, keeping it below anchor 5's 'clear niche with 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/clickhelp/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.