CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

close

Close integration. Manage Organizations. Use when the user wants to interact with Close 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/close/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 strong, executable skill body: every workflow step is backed by a runnable command, credential handling is delegated cleanly, and connection-state errors are handled as an explicit feedback loop. The main defects are a dangling 'Step 2' reference with inconsistent step numbering, an unexplained placeholder in the connection ensure command, and a slightly long single-file layout where the action catalog could be split into a reference.

Suggestions

Fix the workflow numbering: define explicit 'Step 1 / Step 2' headers (or remove the 'skip to Step 2' references) so the '1b' subsection has a coherent parent sequence.

Explain the placeholder in `membrane connection ensure ""` (what URL/domain goes there) and clarify whether the table's 'Key' values are the `<actionId>` accepted by `membrane action run`.

Consider moving the 25-row popular-actions table to a references file (e.g. ACTIONS.md) and keeping a top-5 sample inline, which would let the body stay a lean overview.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — commands, flag tables, and a tight state-handling list — with only minor trimmable padding ('designed to help sales teams close more deals', 'This is the fastest way to get a connection', the rambling 'Agent Types' sentence). It is more efficient than anchor 3 (which includes genuinely unnecessary explanation) but falls short of the lean every-token-earns-its-place anchor 5.

4 / 5

Actionability

Nearly everything is copy-paste ready: install, login, headless completion, connection polling, action search/run, and a proxy flags table. Minor gaps keep it below 5: `membrane connection ensure ""` shows an unexplained empty-string placeholder, 'skip to Step 2' points at a step that is never defined, and the table gives action 'keys' (e.g. list-leads) without confirming those are the IDs `<actionId>` expects.

4 / 5

Workflow Clarity

The sequence (install → login → connection ensure → poll state → search actions → run) is clear, and the connection-state guidance (READY / CLIENT_ACTION_REQUIRED with clientAction fields / CONFIGURATION_ERROR) is a genuine validation feedback loop. Not a 5: the workflow repeatedly says 'skip to Step 2' but no Step 2 is labeled, and the '1b' numbering implies steps 1/2 headers that don't exist, leaving the checkpoint structure implicit. Not a 3: checkpoints for the riskiest step (connection setup) are explicit, including error recovery.

4 / 5

Progressive Disclosure

The single file is well-sectioned with no nested references (no bundle files exist, so nothing is buried or multi-level), and the core actions table is arguably the content an agent needs inline. It is not a 5 under the small-skill exception (the body is ~165 lines, over the 50-line guidance, and the 25-row actions catalog plus proxy flag table could plausibly live in reference files), but structure and navigation within the file are solid, matching anchor 4.

4 / 5

Total

16

/

20

Passed

Description

62%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 serviceable: it names the product, uses third person, and includes an explicit 'Use when' clause. However, 'Manage Organizations' both undersells and misrepresents the skill's actual capabilities (leads, contacts, opportunities, tasks, activities), and it omits the natural vocabulary (CRM, leads, deals, contacts) that would help a user's phrasing trigger it.

Suggestions

Replace 'Manage Organizations' with the skill's actual object coverage, e.g. 'Manage Close leads, contacts, opportunities, tasks, and activities' — 'Organizations' is not a focal entity in the body.

Add natural trigger keywords users would say, such as 'CRM', 'sales pipeline', 'deals', or 'Close CRM', to improve trigger term coverage.

Extend the 'when' clause with concrete trigger phrases, e.g. 'Use when the user mentions Close, asks about leads or opportunities in Close, or wants to automate Close outreach'.

DimensionReasoningScore

Specificity

Names the domain ('Close integration') and one concrete action ('Manage Organizations'), matching the anchor for domain plus 1-2 actions but not comprehensive — leads, opportunities, tasks, and contacts (the skill's main capabilities per the body) are absent, and 'Organizations' is not even the body's focus.

3 / 5

Completeness

Both 'what' ('Close integration. Manage Organizations.') and an explicit 'when' ('Use when the user wants to interact with Close data') are present, and third-person voice is used. Not a 5 because the 'what' is thin and doesn't enumerate concrete capabilities; not a 3 because the 'when' clause is explicit, not missing or merely implied.

4 / 5

Trigger Term Quality

'Close' / 'Close data' are relevant keywords a user of this product would say, but common variations and synonyms are missing — no 'CRM', 'leads', 'deals', 'contacts', 'opportunities', or 'sales'. This matches anchor 3 ('some relevant keywords but missing common variations') better than anchor 2, which describes purely generic keyword coverage.

3 / 5

Distinctiveness Conflict Risk

Naming the specific product 'Close' three times gives it a clear niche with minimal conflict against other integration skills. Not a 5 because 'Manage Organizations' is generic and could overlap with other organization-management skills (e.g., GitHub orgs), and 'close' is a common English word that adds some false-trigger noise.

4 / 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/close/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.