CtrlK
BlogDocsLog inGet started
Tessl Logo

commpeak

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

60

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/commpeak/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, well-structured CLI usage guide with concrete commands and a genuine polling/validation feedback loop for connection setup. Its main weaknesses are minor intro padding and inconsistent step numbering ('Step 2', '1b') that slightly hurts workflow clarity.

Suggestions

Fix the broken step references: either relabel the subsections as Step 1 / Step 2 or remove the 'skip to Step 2' and '1b' markers so the sequence is coherent.

Trim the opening paragraph describing what CommPeak is and remove the placeholder line 'Use action names and parameters as needed.' to tighten token efficiency.

Consider moving the popular-actions table and proxy flag reference into a separate reference file to strengthen progressive disclosure for this 150-line skill.

DimensionReasoningScore

Conciseness

The body is mostly lean executable commands with brief explanations, but the opening paragraph explaining what CommPeak is and asides like 'Use action names and parameters as needed' are minor over-explanation that could be trimmed, fitting the score-4 anchor 'Efficient; minor instances of over-explanation'; not score 5 because the intro padding keeps it from being fully lean.

4 / 5

Actionability

It provides copy-paste-ready commands throughout (install, login, connection ensure/get, action list/run, request) with concrete flags and a popular-actions table covering common cases, matching the score-5 anchor 'Fully executable; copy-paste ready code or commands'; not below 5 because the examples are specific and runnable.

5 / 5

Workflow Clarity

The connection flow is clearly sequenced with a real validation feedback loop (poll until READY, handle CLIENT_ACTION_REQUIRED, re-poll after the user acts), but the document references 'Step 2' and a '1b' subsection that have no matching labeled steps, leaving minor gaps, matching the score-4 anchor 'Clear sequence with most checkpoints present; minor validation gaps'; not score 5 because of the broken step numbering.

4 / 5

Progressive Disclosure

With no bundle files present, the single-file body is organized into clear ## / ### sections and signals its one external reference explicitly ('Official docs: ...'); this fits the score-4 anchor 'Good structure; most content is appropriately placed; references mostly clear'; not score 5 because no internal reference structure exists to navigate and some reference-style content (the proxy flag table, popular-actions table) is inlined.

4 / 5

Total

17

/

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 cleanly states both purpose and a trigger condition anchored to the distinct CommPeak product name, but its capability list is generic ('manage data, records, and automate workflows') and the trigger phrasing is somewhat circular. It is distinctive and complete enough to score well, just not crisp on specifics.

Suggestions

Replace generic actions with concrete CommPeak capabilities, e.g. 'Run HLR/LRN/DNC phone number lookups, download lookup results, and query call recordings'.

Expand the trigger with natural user phrases such as 'Use when the user wants to look up phone numbers, check number validity, or retrieve CommPeak call/contact data'.

Include common synonyms or entities (e.g. 'phone number lookup', 'HLR lookup', 'call recordings') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the CommPeak domain but the actions 'Manage data, records, and automate workflows' are minimal and generic rather than concrete capabilities, matching the score-2 anchor 'Names the domain but actions are minimal or generic'; it does not reach score 3 because no concrete CommPeak-specific actions are listed.

2 / 5

Completeness

It states both a 'what' ('Manage data, records, and automate workflows') and a 'when' ('Use when the user wants to interact with CommPeak data'), but the 'when' is somewhat circular and the 'what' is generic, matching the score-4 anchor where 'when' could be more explicit; it does not reach score 5 because the trigger phrases and capability list are not concrete.

4 / 5

Trigger Term Quality

It includes the product name 'CommPeak' plus 'data', 'records', and 'workflows' as relevant keywords, but lacks common variations or synonyms a user might naturally say, fitting the score-3 anchor 'Some relevant keywords but missing common variations or synonyms'; not score 4 because keyword coverage is thin beyond the product name.

3 / 5

Distinctiveness Conflict Risk

Naming the specific product 'CommPeak' and triggering on 'interact with CommPeak data' carves a clear niche with minimal conflict risk against other skills, matching the score-5 anchor 'Clear niche with distinct triggers'; it is not score 4 because the product name makes overlap risk very low.

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.

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.