CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

capsule-crm

Capsule CRM integration. Manage crm and sales data, records, and workflows. Use when the user wants to interact with Capsule CRM data.

Quality

74%

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

Quality

Content

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

This is a highly actionable, command-first skill: every workflow step has an executable CLI command, JSON flags, and a useful actions catalog, and the connection-state branching shows real error-recovery thinking. The weaknesses are unneeded background prose (the CRM explainer and empty entity list) and missing validation safeguards for destructive operations, plus a dangling "Step 2" reference that breaks the stated sequence.

Suggestions

Delete the opening "Capsule CRM is a customer relationship management (CRM) platform..." paragraph and the bare entity bullet list — Claude already knows what a CRM is, and the list carries no actionable information.

Add a validation checkpoint before destructive actions, e.g. "Before running delete-project/delete-task, confirm the record ID with the user and verify it via get-project/get-task" — the rubric caps workflow clarity for destructive operations without validation.

Fix the dangling navigation: replace "skip to **Step 2**" with the actual section name (e.g. "skip to Searching for actions") and rename or remove the "1b" heading so the heading hierarchy is coherent.

DimensionReasoningScore

Conciseness

The body is mostly efficient (commands, flags table, actions table) but includes unnecessary explanation Claude does not need: "Capsule CRM is a customer relationship management (CRM) platform. It helps small to medium-sized businesses manage contacts, sales pipelines..." and a content-free entity list ("**Opportunity**, **Track**, **Case**...") with no descriptions, plus prose like "This is the fastest way to get a connection. The URL is normalized to a domain...". This matches anchor 3 (mostly efficient, some unnecessary explanation) rather than anchor 4, where only minor trimming would be needed — the intro paragraph and entity list add no actionable value.

3 / 5

Actionability

Every step ships copy-paste-ready commands: "npm install -g @membranehq/cli@latest", "membrane login --tenant --clientName=<agentType>", "membrane connection ensure \"https://capsulecrm.com/\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json", and a complete flag table for proxy requests. The 20-row popular-actions table covers the common cases with concrete keys, matching anchor 5; it is not lower because no step relies on pseudocode or vague direction.

5 / 5

Workflow Clarity

A sequence exists (install → login → connection ensure → wait for READY → search actions → run → proxy fallback) with state-based branching for CLIENT_ACTION_REQUIRED, but it hits the rubric's destructive-operation cap: the actions catalog includes "Delete Project" and "Delete Task" yet no validation or confirmation guidance exists for destructive operations (no verify-the-ID / confirm-with-user step). It also matches anchor 3 rather than 4 due to an incoherent reference — "skip to **Step 2**" points at sections that are never numbered, leaving checkpoints implicit.

3 / 5

Progressive Disclosure

The single SKILL.md (no bundle files present) is well-organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with the actions table and flag table appropriately inline as the core discovery surface, and only an external docs URL as a reference. It is not 5 because the >50-line body keeps material like the full 20-row actions table and proxy flag table inline where a reference file split could apply, and stray structure issues ("1b" heading with no "1", the "Step 2" reference) slightly hurt navigation — but these are minor gaps consistent with anchor 4.

4 / 5

Total

15

/

20

Passed

Description

68%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 a distinct product niche and includes an explicit trigger clause, so it answers both what and when without fluff. Its main weakness is generic verb-based capability language — "Manage crm and sales data, records, and workflows" — that fails to convey concrete actions or the natural CRM vocabulary (contacts, leads, opportunities) users would say.

Suggestions

Replace the generic "Manage crm and sales data, records, and workflows" with concrete actions, e.g. "Create, update, and delete Capsule CRM contacts, organizations, opportunities, tasks, and projects".

Broaden the trigger clause to include natural CRM phrasings: "Use when the user mentions Capsule CRM, or wants to manage contacts, leads, sales opportunities, or tasks in Capsule."

Fix the lowercase "crm" in "Manage crm and sales data" to "CRM" for consistent, professional naming.

DimensionReasoningScore

Specificity

"Manage crm and sales data, records, and workflows" names the domain (Capsule CRM) but every action is a generic verb on generic objects — no concrete operations like creating contacts, tracking opportunities, or managing tasks. This matches anchor 2 ("Names the domain but actions are minimal or generic") rather than anchor 3, which requires 1-2 concrete actions akin to "extracts content".

2 / 5

Completeness

Both parts are present: the "what" ("Manage crm and sales data, records, and workflows") and an explicit "Use when the user wants to interact with Capsule CRM data" trigger. It is not a 5 because the "when" clause is narrow (only "interact with... data") and the "what" leans on generic verbs, so neither is fully concrete.

4 / 5

Trigger Term Quality

Terms "Capsule CRM", "crm and sales data", "records", and "workflows" give good natural-keyword coverage of the domain. It falls short of anchor 5 because common CRM phrasings users actually say — contacts, leads, opportunities, deals, sales pipeline — are absent.

4 / 5

Distinctiveness Conflict Risk

"Capsule CRM" is a specific product name appearing in both the what and when clauses, giving a clear niche with distinct triggers and minimal conflict risk against generic CRM/sales skills. The rubric's third-person voice requirement is met ("Manage..."), so no penalty applies.

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/capsule-crm/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.