CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chaport

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

Quality

68%

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

Quality

Content

65%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 tight, highly actionable guide to driving Chaport through the Membrane CLI, with executable commands and a well-documented connection state machine. Its main gaps are the missing validation guidance around destructive actions (delete-visitor/delete-operator), a broken "Step 2" cross-reference, and no progressive disclosure — the entire action catalog and CLI reference live inline in SKILL.md.

Suggestions

Add validation/confirmation steps before destructive actions — e.g., verify the target with `get-visitor` and confirm with the user before running `delete-visitor`, and state this in a short "Destructive operations" note.

Fix the dangling cross-reference: "skip to **Step 2**" points to a step label that doesn't exist; either label the sections as Steps 1/2 consistently or reference the section by name.

Split the 19-row action catalog and the proxy flags table into a references/ file (e.g., references/actions.md), keeping a handful of the most common actions inline in SKILL.md as a quick-start pointer.

DimensionReasoningScore

Conciseness

Nearly every token is executable guidance Claude cannot know (Membrane CLI commands, connection state machine, action catalog, proxy flags). Only minor instances are trimmable — the bare "Chaport Overview" entity list, "This is the fastest way to get a connection…", and the rambling "Agent Types… will be used to adjust tooling" sentence. It is not 5 because those few sentences and the padding in "Best practices" ("This will burn less tokens") do not fully earn their place.

4 / 5

Actionability

Concrete, copy-paste-ready commands cover install, login (including headless completion), connection lifecycle, action search/run with --input, and proxied API requests with a flags table. It is not 5 because no worked example ties an action key from the table (e.g., list-visitors or send-message) to a fully populated `membrane action run` invocation; placeholders like <actionId> and QUERY are never instantiated.

4 / 5

Workflow Clarity

The install → login → connection ensure → poll → search → run sequence is clear, with state-based feedback loops (CLIENT_ACTION_REQUIRED → user acts → poll again). However, destructive operations (delete-visitor, delete-operator) ship with no validation or confirmation steps, which caps workflow clarity at 3 per the rubric; additionally, "skip to **Step 2**" references a step label that does not exist anywhere in the document.

3 / 5

Progressive Disclosure

No bundle files exist, so everything — the 19-row action catalog, the proxy flag table, and the clientAction state documentation — is inlined in a single ~160-line SKILL.md. Structure is decent (clear section headers), but content that belongs in a references/ file (the full action catalog) is inline and the dangling "Step 2" cross-reference hurts navigation. It is not 2 because organization is clearly present; not 4 because reference material is not split out at all.

3 / 5

Total

14

/

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 Chaport domain and includes an explicit "Use when" clause, but the capability statement is generic boilerplate that never reveals what Chaport is (a live chat platform) or what can actually be done (chats, visitors, operators, messages). Trigger coverage stops at the brand name, so a user describing the task functionally ("live chat", "chat with website visitors") would not surface this skill.

Suggestions

Name concrete operations and objects instead of "Manage data, records, and automate workflows" — e.g., "List, update, and delete visitors and operators; send and update chat messages via the Chaport API."

Add functional trigger terms users naturally say, such as "live chat", "chatbot", "website visitors", or "support team", so the skill triggers even when the user doesn't name Chaport explicitly.

Briefly state what Chaport is in the description (a live chat/chatbot platform) so both the "what" and the trigger context are self-contained.

DimensionReasoningScore

Specificity

The only actions named are "Manage data, records, and automate workflows" — generic verbs with no concrete operations or objects (nothing about chats, visitors, operators, or messages). This matches the anchor "Names the domain but actions are minimal or generic"; it is not a 3 because no concrete action like "list visitors" or "send messages" is stated.

2 / 5

Completeness

Both parts are explicitly present: the "what" ("Manage data, records, and automate workflows") and the "when" ("Use when the user wants to interact with Chaport data"). This fits anchor 4 — both present but could be more specific; it is not 5 because the "what" lacks concrete trigger phrases, and not 3 because the "when" clause is explicit rather than missing or weakly implied.

4 / 5

Trigger Term Quality

"Chaport" is a relevant, specific trigger keyword (analogous to "Works with PDF files"), but no natural variations or synonyms are present — "live chat", "chatbot", "visitors", "operators", or "support" are all absent. It is not a 4 because the trigger vocabulary extends no further than the brand name repeated in the "Use when" clause.

3 / 5

Distinctiveness Conflict Risk

The "Chaport" brand name carves a clear niche with minimal conflict risk. It is not 5 because the boilerplate "Manage data, records, and automate workflows" is generic language shared by virtually any app-integration skill, creating minor overlap risk with closely related integration skills.

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