CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commpeak

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

Quality

66%

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

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 content is a solid, executable CLI workflow guide with strong connection-state handling and feedback loops. Weaknesses are modest: some filler prose, a generic action-run example, dangling 'Step 2' references, and an organization that could offload reference material to bundle files. Tightening these would lift it to a top-tier skill.

Suggestions

Remove the marketing filler ('It's used by businesses, particularly in sales and marketing...') and the contentless 'Use action names and parameters as needed' line, and fix the truncated table cell in the Popular actions table.

Fix the dangling internal references: either label the 'Searching for actions' section as Step 2 or remove the 'skip to Step 2' phrasing, and reconcile the '1b' heading with a matching '1a'.

Add one realistic end-to-end example, e.g. running sync-lookup with an actual phone number and showing the expected output structure, and move the popular-actions table to a references file to reduce inline bulk.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete commands, but includes filler: 'It's used by businesses, particularly in sales and marketing, to improve customer engagement and communication strategies', the contentless 'Use action names and parameters as needed', and a truncated table cell ('...vali...'). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than score 4, which allows only minor trims.

3 / 5

Actionability

Nearly all guidance is copy-paste executable: install, login (including headless flow), connection ensure with a real URL, state polling, action list/run, and a proxy flag table. It falls short of score 5 because the parameter example '--input '{"key": "value"}'' is generic — no realistic CommPeak example (e.g., a sync-lookup with an actual phone number) is shown.

4 / 5

Workflow Clarity

The setup-to-execution sequence is clear with genuine feedback loops: explicit state polling, CLIENT_ACTION_REQUIRED handling, re-polling after user action, and error-state guidance. It does not reach 5 because 'skip to Step 2' references a step that is never defined and section '1b' has no '1a' — minor but real sequence incoherence rather than a pure validation gap.

4 / 5

Progressive Disclosure

The ~150-line single-file skill (no bundle files exist) is well-organized with clear section headers and appropriately scoped content. It does not reach 5 because at this length the popular-actions table and proxy reference detail could reasonably live in a referenced file, and the skill is past the under-50-line simple-skill threshold.

4 / 5

Total

15

/

20

Passed

Description

50%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 short and has an explicit 'Use when' clause, but its capability statement is generic marketing-style filler that omits the skill's actual purpose (CommPeak voice/SMS/lookup operations). Trigger coverage depends entirely on the product name. Concrete capability wording and natural user phrases would substantially improve it.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete capabilities drawn from the actual actions, e.g. 'Run HLR/LRN/DNC phone number lookups, manage contacts, lists, numbers, tasks, and users, and send proxied requests to the CommPeak API'.

Expand the trigger clause with natural user phrases, e.g. 'Use when the user mentions CommPeak, phone number lookups, HLR/LRN/DNC checks, or wants to query call, SMS, or contact data in CommPeak'.

Keep the third-person, 'Use when...' structure but ensure the 'what' statement is as specific as the 'when' statement so both halves of the description are concrete.

DimensionReasoningScore

Specificity

The description names the domain ("CommPeak integration") but its actions are generic — "Manage data, records, and automate workflows" — with no concrete capabilities like phone number lookups, SMS, or call recordings that the skill actually provides. It matches the anchor 'Names the domain but actions are minimal or generic' rather than score 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both 'what' ("Manage data, records, and automate workflows") and an explicit 'when' ("Use when the user wants to interact with CommPeak data") are present. It does not reach 5 because the 'what' is vague where the anchor-5 example requires concrete, specific actions alongside the trigger phrase.

4 / 5

Trigger Term Quality

The only natural trigger term is "CommPeak" itself; users would say things like 'look up this phone number', 'check my SMS/voice data', or 'call recordings', none of which appear. This matches 'One or two generic keywords; missing the natural phrases users say' rather than score 3, which expects some relevant keywords beyond the app name.

2 / 5

Distinctiveness Conflict Risk

The distinct 'CommPeak' product name gives a clear niche with low conflict risk, but the generic 'manage data, records, and automate workflows' phrasing adds minor overlap risk with other app-integration skills. Not 5, since the trigger coverage relies solely on the product name without reinforcing domain terms like phone lookup or SMS.

4 / 5

Total

12

/

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