CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chaindesk

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

Quality

72%

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

Quality

Content

72%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.

A highly actionable CLI-driven skill with excellent copy-paste commands and state-handling guidance for the connection flow. Its main weaknesses are a dangling "Step 2" cross-reference, no validation guidance around destructive delete actions, and a monolithic single-file layout where an actions reference could be split out.

Suggestions

Fix the workflow numbering: the text says "skip to **Step 2**" but no Step 2 heading exists — label the connection, search, and run sections as explicit numbered steps and remove the orphan "1b" heading.

Add validation guidance for destructive actions: before running delete-datasource / delete-datastore / delete-agent, fetch the object with the corresponding get action to confirm the ID, and confirm with the user when deletion is irreversible.

Consider moving the full popular-actions table into a references/ file (e.g. ACTIONS.md) with a few flagship examples kept inline, and trim filler lines like "Use action names and parameters as needed."

DimensionReasoningScore

Conciseness

The body is dominated by executable commands and tables rather than concept explanations, with only minor trimmable filler ("Use action names and parameters as needed.", "This is the fastest way to get a connection.", and the awkward agent-types sentence). Matches anchor 4 (efficient, minor over-explanation), not 5 because a few sentences and the thin "Chaindesk Overview" bullet list don't earn their tokens.

4 / 5

Actionability

Every step ships a copy-paste-ready command: `npm install -g @membranehq/cli@latest`, `membrane login`, `membrane connection ensure "https://www.chatbotgpt.ai/" --json`, action search/run with a concrete `--input '{"key": "value"}'` example, and a proxy flag table. The 15-row popular-actions table with action keys covers the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The connect → poll state → search → run sequence exists with state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR handling), but "skip to **Step 2**" references a heading that never appears (steps are unnumbered apart from "1b"), and destructive actions (delete-datasource, delete-datastore, delete-agent) are listed with no verify-before-delete or confirmation guidance. The destructive/batch validation cap applies, holding this at 3 rather than 4.

3 / 5

Progressive Disclosure

This is a single ~155-line file with no references/ or other bundle files — everything is inlined, including a 15-row actions table and the proxy flag reference that read like reference-file material. Section headers give decent navigation, but nothing is offloaded to a separate file, matching anchor 3 (some structure, content that could be separate is inline) rather than 4 (which expects most content appropriately split or placed).

3 / 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 clear explicit "Use when" trigger and is highly distinctive thanks to the Chaindesk product name, but the capability statement is generic. Naming the actual objects users manipulate (datasources, datastores, chatbots, agents) would raise both specificity and trigger coverage.

Suggestions

Replace the vague "Manage data, records, and automate workflows" with concrete capabilities, e.g. "Manage Chaindesk datasources, datastores, AI agents, and support conversations".

Expand the trigger clause to include natural variations: "Use when the user mentions Chaindesk, datasources, datastores, chatbot agents, or querying a Chaindesk datastore".

Drop the filler word "records", which duplicates "data" without adding a searchable term.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain but the actions are generic — "data" and "records" are vague abstractions, and concrete capabilities visible in the body (datasources, datastores, chatbot agents, conversations) are never named. It falls below anchor 3 because not even one or two truly concrete actions are stated.

2 / 5

Completeness

Both parts are present: what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Chaindesk data"). Not 5 because the "what" is vague — it doesn't convey concrete capabilities — keeping it at anchor 4 (both present, one could be more specific).

4 / 5

Trigger Term Quality

"Chaindesk" is a relevant, natural keyword users would say, but no variations or synonyms appear (datasource, datastore, chatbot, agent, knowledge base, support conversations). Matches anchor 3 (relevant keyword present, common variations missing), not 4 which requires broader keyword coverage.

3 / 5

Distinctiveness Conflict Risk

"Chaindesk" is a specific product name creating a clear niche with a distinct trigger ("interact with Chaindesk data"), with minimal overlap risk against other skills. Clearly matches anchor 5.

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