CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chatsonic

Chatsonic integration. Manage Users, Chats, Images, Workspaces, Prompts. Use when the user wants to interact with Chatsonic 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/chatsonic/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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-sectioned, command-rich guide whose membrane CLI instructions are largely executable, and connection-state checkpoints are explicitly documented. Its main defects are padding in the overview/best-practices prose, a dangling 'skip to Step 2' reference with no Step 2 heading, and reference-style tables that could be split out of the main file.

Suggestions

Fix the broken step numbering: either add labeled 'Step 1 / Step 2' headings or reword to 'skip to \"Searching for actions\"' so the 'skip to Step 2' reference resolves.

Trim non-operational prose: the Chatsonic marketing/background sentences, 'Use action names and parameters as needed.', and the CLI-internal URL normalization explanation.

Complete the Popular actions table's empty Description column and add one end-to-end example (search for an action by intent, then run it with a real input and inspect the output field).

DimensionReasoningScore

Conciseness

The body is mostly command-driven, but contains unnecessary padding: a background paragraph about what Chatsonic is and who uses it ("It's used by marketers, writers, and researchers..."), the filler line "Use action names and parameters as needed.", and CLI-internal explanation ("The URL is normalized to a domain and matched against known apps..."). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened', not the 'minor instances' of anchor 4.

3 / 5

Actionability

Concrete runnable commands appear throughout ("npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://writesonic.com/chat\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}'", plus a full proxy flag table). Minor gaps: the Popular actions table has an empty Description column and there is no end-to-end example with a real action ID and output, so it falls short of anchor 5.

4 / 5

Workflow Clarity

A real sequence exists (install → login → connection ensure → poll state → search actions → run) with explicit state checkpoints (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a re-poll loop. However it contains a dangling navigation defect: "If the returned connection has state: READY, skip to Step 2" — but no Step 2 heading exists (only an unanchored "1b" heading), making the numbered sequence incoherent and fitting 'sequence present but checkpoints missing or implicit' rather than the fully coherent anchor 4.

3 / 5

Progressive Disclosure

No bundle files exist; the skill is a single ~145-line SKILL.md with well-organized section headers (Install → Authentication → Connecting → Searching → Running → Proxy → Best practices) and no nested references. This matches 'good structure; most content is appropriately placed; minor organization gaps'. Not 5 because it exceeds 50 lines and contains reference-style tables (proxy flags, clientAction schema) that could be split into a separate reference file.

4 / 5

Total

14

/

20

Passed

Description

66%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 names a distinct product with an explicit 'Use when' clause and a clear object inventory, giving it good distinctiveness and completeness. Its weaknesses are the single generic verb "Manage" covering all capabilities and a circular, low-variation trigger clause.

Suggestions

Replace the generic verb with concrete actions, e.g. "Send chat messages, generate images, and manage users, workspaces, and prompts in Chatsonic."

Expand the 'Use when' clause with concrete trigger phrases such as "Use when the user mentions Chatsonic, wants to send a Chatsonic message, or generate a Chatsonic image."

Add natural synonyms (e.g., WriteSonic, Chatsonic API) so the description triggers on phrasings users actually say.

DimensionReasoningScore

Specificity

Names the domain and five concrete object categories ("Manage Users, Chats, Images, Workspaces, Prompts"), but the single verb "Manage" is generic, so no concrete actions like "send messages" or "generate images" are stated. It sits above anchor 2 because the enumerated objects give more concrete scope than "Processes PDF files", but below anchor 4 because every action verb is generic.

3 / 5

Completeness

Has both a 'what' ("Manage Users, Chats, Images, Workspaces, Prompts") and an explicit 'when' ("Use when the user wants to interact with Chatsonic data"). Not 5 because the 'when' clause is circular ("interact with Chatsonic data") rather than concrete trigger phrases; not 3 because the 'when' is explicitly stated, not weakly implied.

4 / 5

Trigger Term Quality

"Chatsonic" is the key natural keyword a user would say, plus object nouns ("Chats", "Images", "Workspaces"), but common variations and synonyms (WriteSonic, chatbot, AI content generation) are missing. This matches the anchor for some relevant keywords without variations.

3 / 5

Distinctiveness Conflict Risk

Chatsonic is a specific named product, and the description anchors all triggers to it ("Chatsonic integration", "interact with Chatsonic data"), giving a clear niche with minimal conflict risk against other skills. The generic nouns (Users, Chats) are qualified by the product name, so it does not fall to anchor 4.

5 / 5

Total

15

/

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