CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cohere

Cohere integration. Manage Documents, Models, Datasets, Jobs. Use when the user wants to interact with Cohere data.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/cohere/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 delivers strong executable guidance: real CLI commands for auth, connection setup with state-aware polling, action search/execution, and a proxy escape hatch. Weaknesses are an introductory paragraph and capability bullets that explain what Claude already knows, incoherent step numbering ('Step 2' and '1b' with no anchors), and no progressive disclosure despite a length that warrants splitting detail into reference files.

Suggestions

Cut the opening paragraph explaining what Cohere is and merge the Overview bullets into the Popular actions table, which already conveys the same capability list.

Fix the sequence labeling: either number the steps ('Step 1: Connect', 'Step 2: Search actions') or drop the 'skip to Step 2' and '1b' references.

Add one fully worked end-to-end example (e.g. running the embed action with a real --input payload and the resulting output), and move the connection-state/clientAction internals and proxy flag table into a references/ file.

DimensionReasoningScore

Conciseness

The body opens with background Claude already knows ("Cohere provides access to advanced language models through an API. Developers and businesses use it to build AI-powered applications...") and the Overview bullets re-explain familiar concepts ("Creates vector representations of text for semantic search") while partially duplicating the Popular actions table. The command sections themselves are compact, so this is 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

Concrete copy-paste-ready commands cover install, login, connection, action discovery/execution with JSON input, and proxying, plus a flag table. Minor gaps keep it below 5: no fully worked example with real values, the action table lists 'Key' values while run examples use an undefined '<actionId>' placeholder, and COMMAND_ID/actionId correspondence is never stated.

4 / 5

Workflow Clarity

The sequence (install CLI, login, connect, handle states, search actions, run, proxy fallback) is clear, and the connection-state polling loop with CLIENT_ACTION_REQUIRED handling is an explicit checkpoint with a retry path. However, the text says 'skip to Step 2' though no 'Step 2' heading exists, and a '#### 1b' section appears with no '1a' or 'Step 1', leaving the numbering incoherent — minor sequence/labeling gaps consistent with a 4.

4 / 5

Progressive Disclosure

This is a single-file skill with no references/, scripts/, or assets/ directories; at ~148 lines it exceeds the 50-line simple-skill threshold, and inline material that could live in reference files (the detailed connection-state/clientAction internals, the proxy flag reference table) is all in SKILL.md. Structure via headers and tables is decent, matching 'some structure but content that should be separate is inline'.

3 / 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 correctly includes both a capability statement and an explicit 'Use when...' clause anchored to a distinct brand niche. Its weakness is generic capability language: 'Manage Documents, Models, Datasets, Jobs' conveys neither concrete actions nor the natural trigger terms (embed, summarize, chat, rerank) users would actually say.

Suggestions

Replace the generic verb 'Manage' with the concrete actions the skill actually supports, e.g. 'Generate text and chat responses, classify, embed, rerank, and tokenize with Cohere models'.

Add natural trigger keywords and synonyms to the 'Use when' clause, e.g. 'Use when the user mentions Cohere, wants to embed or rerank text, or needs Cohere chat/summarization'.

Reconcile the resource list with actual capabilities — the body covers models, chat, embed, rerank, classify, tokenize, and summarize, not 'Documents, Datasets, Jobs'.

DimensionReasoningScore

Specificity

The description names the Cohere domain and four resource types ("Manage Documents, Models, Datasets, Jobs") but relies on a single generic verb "Manage" rather than concrete actions like embed, summarize, chat, or rerank, matching the 'names domain and 1-2 concrete actions' anchor rather than 'lists several specific actions'.

3 / 5

Completeness

Both a 'what' ("Manage Documents, Models, Datasets, Jobs") and an explicit 'when' ("Use when the user wants to interact with Cohere data") are present, but the trigger clause is generic and lacks concrete trigger phrases, matching the 'when could be more explicit or specific' anchor rather than a 5.

4 / 5

Trigger Term Quality

The only substantive keyword is the brand name "Cohere" plus the phrase "interact with Cohere data"; natural capability terms users would say (embed, summarize, rerank, chat) are absent, similar to the 'Works with PDF files' anchor with relevant keywords but missing variations.

3 / 5

Distinctiveness Conflict Risk

The description is anchored to a distinct named niche (Cohere) with brand-specific triggers, giving it a clear scope with minimal risk of firing for unrelated skills.

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