CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cherwell-itsm

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

Quality

70%

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/cherwell-itsm/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 strong, command-driven integration guide with genuine error-recovery checkpoints around connection states. Its main weaknesses are token padding (the overview noun-list and intro), a 'Popular actions' section that names no actions, and broken step cross-references ('Step 2', '1b') that confuse the otherwise clear workflow.

Suggestions

Delete or compress the 'Cherwell ITSM Overview' noun bullet list ('Business Object, Relationship, ...' with 'Use action names and parameters as needed') and the introductory paragraph explaining what Cherwell ITSM is — this is padding Claude does not need.

Either list several actual popular actions with example parameters under 'Popular actions', or remove the section and fold the discovery command into 'Searching for actions' to avoid duplication.

Fix the workflow numbering: label the post-connection sections (e.g. 'Step 2: Search for actions', 'Step 3: Run actions') so the existing 'skip to **Step 2**' references resolve, and rename or remove the orphaned '1b' heading.

DimensionReasoningScore

Conciseness

The command examples and flag table are efficient, but several sections pad the token budget: the intro paragraph explaining what Cherwell ITSM is, the 'Cherwell ITSM Overview' bullet list of nouns ending in 'Use action names and parameters as needed', and the vague 'Agent Types' aside. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where only minor instances would remain.

3 / 5

Actionability

Nearly all guidance is executable and copy-paste ready: npm install, membrane login with headless completion, connection ensure/get with --wait, action list/run with --input examples, and the proxy command with a concrete flag table. It falls short of anchor 5 mainly because the 'Popular actions' section lists no actual actions — only a discovery command — leaving the most common use cases unspecified.

4 / 5

Workflow Clarity

The sequence (install → authenticate → connection ensure → poll state → handle CLIENT_ACTION_REQUIRED / error states → search → run → proxy fallback) is clear with real checkpoints: state polling, clientAction branching, and checking the error field on CONFIGURATION_ERROR. It does not reach anchor 5 because the 'skip to **Step 2**' cross-references point to a step that is never labeled, and the '1b' heading appears without a corresponding step 1, leaving the numbering partially incoherent.

4 / 5

Progressive Disclosure

There are no bundle files, and the ~145-line body is organized into clear sections with headers, a code block per command, and a well-placed options table — no nested or buried references. It matches anchor 4 ('Good structure; most content is appropriately placed') rather than 5, mainly because the 'Cherwell ITSM Overview' section is filler that adds no navigational value.

4 / 5

Total

15

/

20

Passed

Description

61%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 a strong, distinctive trigger (the Cherwell ITSM product name) and correctly answers both what and when, but its capability statement is generic. Replacing 'Manage data, records, and automate workflows' with concrete operations and adding natural synonyms would lift it substantially.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete capabilities, e.g. 'Create, update, and search incidents, service requests, and change records; run saved searches and reports; manage attachments and teams'.

Expand the 'Use when' clause with natural trigger phrases users actually say, such as 'Cherwell', 'ITSM', 'service desk', 'tickets', 'incidents', or 'service requests'.

Consider mentioning key record types or workflows (e.g. incidents, problems, changes) in the description so the skill's scope is explicit without relying on the body.

DimensionReasoningScore

Specificity

The description names the domain ('Cherwell ITSM integration') but its actions — 'Manage data, records, and automate workflows' — are entirely generic, with no concrete capability such as working with incidents, tickets, or service requests. This matches the anchor 'Names the domain but actions are minimal or generic' and falls below anchor 3 because none of the stated actions are concrete.

2 / 5

Completeness

Both parts are present: 'Cherwell ITSM integration. Manage data, records, and automate workflows' states what it does (though generically), and 'Use when the user wants to interact with Cherwell ITSM data' is an explicit when clause. It does not reach anchor 5 because the 'what' lacks concrete capability enumeration and the trigger phrase is narrow.

4 / 5

Trigger Term Quality

It includes the distinctive product name 'Cherwell ITSM' twice, which is the term a user would most naturally say, but misses common variations and synonyms like 'tickets', 'incidents', 'service requests', 'ITSM', or 'service desk'. This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than 4, where keyword coverage would be good.

3 / 5

Distinctiveness Conflict Risk

Cherwell ITSM is a specific named platform and the triggers are tied to that product name, giving a clear niche with minimal risk of firing for unrelated skills. This clearly matches anchor 5 ('Clear niche with distinct triggers; minimal conflict risk') rather than anchor 4, which requires some overlap risk with closely related skills.

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

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/cherwell-itsm/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.