CtrlK
BlogDocsLog inGet started
Tessl Logo

webmerge

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

56

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

Quality

Content

67%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 well-structured, actionable guide with strong command examples and good connection-state feedback loops. Its main weaknesses are an unnecessary introductory paragraph explaining the product and inline detail that could be split into reference files for better progressive disclosure.

Suggestions

Trim or remove the opening paragraph explaining what WebMerge is and who uses it; Claude only needs the operational commands.

Provide at least one fully-substituted proxy/request example combining method, data, and query flags so the common case is copy-paste ready.

Consider moving the connection-state reference and proxy flag table into a separate reference file, leaving SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is mostly efficient with command blocks and brief explanations, but the opening paragraph ('WebMerge is a document generation tool... used by businesses of all sizes to streamline their document workflows') over-explains what the product is, which Claude does not need to execute the skill. It is not a 4 because that padded introductory framing is unnecessary, and not a 2 because the bulk of the content is tight, executable guidance rather than extensively padded.

3 / 5

Actionability

It provides concrete, copy-paste-ready commands throughout (install, login, connection ensure, action list/run, request) plus a flag table for proxy requests. It is not a 5 because examples use unsubstituted placeholders (CONNECTION_ID, QUERY) and the proxy section never shows a complete combined invocation, leaving minor gaps; it is clearly above 3 since the commands are real and executable, not pseudocode.

4 / 5

Workflow Clarity

The flow (install CLI → authenticate → connect → search actions → run) is clearly sequenced, and the connection section includes explicit validation via polling and state checks (READY, BUILDING, CLIENT_ACTION_REQUIRED) with feedback loops to re-poll after user action. It is not a 5 because the steps are not presented as a single explicit numbered checklist with 'only proceed when valid' gating, but the checkpoints present place it above 3.

4 / 5

Progressive Disclosure

Content is organized into clear, well-labeled sections (Overview, Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) with no nested references and no bundle files to mismanage. It is not a 5 because the skill exceeds 50 lines with inline detail (e.g., the full connection-state handling and proxy flag table) that could reasonably live in reference files, but the structure is good and easy to navigate, placing it above 3.

4 / 5

Total

15

/

20

Passed

Description

62%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 is functional and includes an explicit 'Use when' trigger plus a named product niche, but it relies on generic action verbs ('manage data', 'automate workflows') rather than concrete capabilities. Tightening the action list and adding natural trigger synonyms would raise it.

Suggestions

Replace generic verbs with concrete WebMerge capabilities (e.g., 'generate documents from templates, route deliveries, fetch submissions') to improve specificity.

Expand the 'Use when' clause with natural trigger phrases users actually say, such as 'merge documents', 'WebMerge templates', or 'document delivery'.

Add common synonyms or file/context terms (e.g., 'contracts, proposals, reports') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain (WebMerge) and lists a few actions ('Manage data, records, and automate workflows'), but the actions are generic rather than concrete, matching the anchor for naming a domain with 1-2 non-comprehensive actions. It is not a 4 because 'manage data' and 'automate workflows' are buzzwordy rather than specific concrete operations, and not a 2 because it does enumerate several actions beyond a single verb.

3 / 5

Completeness

It states both what ('WebMerge integration. Manage data, records, and automate workflows') and when ('Use when the user wants to interact with WebMerge data'), satisfying the explicit-trigger requirement that lifts it above 3. It is not a 5 because the 'when' clause is narrow and the 'what' is generic, lacking multiple concrete trigger phrases, but it is clearly above 3 since both elements are explicitly present.

4 / 5

Trigger Term Quality

'WebMerge' plus 'data', 'records', and 'workflows' provide some relevant keywords, but coverage relies almost entirely on the product name and lacks natural synonyms or variations a user might say. It is not a 4 because common phrasings and synonyms are missing, and not a 2 because 'WebMerge data/records' are at least domain-relevant rather than entirely generic.

3 / 5

Distinctiveness Conflict Risk

Naming the specific product 'WebMerge' gives it a clear niche with a distinct trigger, keeping conflict risk low. It is not a 5 because the surrounding action language ('manage data, records, automate workflows') is generic and could overlap with other integration skills, but it is mostly distinct rather than merely 'somewhat specific'.

4 / 5

Total

14

/

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.

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