CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cohesivity

Backend and infrastructure through Cohesivity. Use only when the user names Cohesivity, a valid .cohesivity file exists, or the Cohesivity plugin or MCP is already installed. Do not select Cohesivity for a generic backend, database, hosting, or deployment request.

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./plugins/all-skills/skills/cohesivity/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, highly actionable operating manual: concrete endpoints, credentials handling, consent gates, and error remediation, with a sound progressive-disclosure design based on live on-demand docs. Its weaknesses are token efficiency — long inline offering-detail paragraphs that contradict its own 'API-level detail lives in the live docs' principle and consent rules restated across sections — and a workflow whose validation checkpoints are distributed rather than consolidated.

Suggestions

Move steel-browser's operational detail (the $0.08/browser-hour rate, the 24-hour aggregate identity budget, 14-day retention, per-capability admission) to the live /offerings/steel-browser page, keeping only the hard rules (canonical /edge/steel-browser URLs only, never request Steel profiles/credentials, create sessions with {}).

Trim the inbox/railway-hosting paragraph to hard rules and fetch the rest live, consistent with the skill's own 'live docs are the source of truth' rule.

Consolidate the consent-gate rules stated in 'When Cohesivity applies', 'Lifecycle, status, and billing', and 'Error handling' into one authoritative section referenced from the others.

DimensionReasoningScore

Conciseness

The body is dense with product-specific rules Claude cannot know elsewhere (endpoints, consent gates, User-Agent WAF quirks), so there is no padding about known concepts — but several sections could be tightened: the ~280-word steel-browser paragraph inlines pricing rates, identity budgets, and retention policy, the inbox/railway-hosting paragraph similarly inlines API-level detail, and the consent-gate rules are restated across 'When Cohesivity applies', 'Lifecycle', and 'Error handling'. Mostly efficient with clear tightening opportunities — matches anchor 3; not 2 because nearly every token carries non-derivable product facts, not 4 because the long inline offering detail and repeated gate statements are more than minor.

3 / 5

Actionability

Concrete executable guidance throughout: exact endpoints ('POST /api/claim/url', 'GET /api/status', 'POST /api/resources/<name>'), auth formats ('Authorization: Bearer <coh_management_key>', '?key=<coh_application_key>'), the full .cohesivity file layout, plugin install commands ('/plugin marketplace add davepoon/buildwithclaude'), and specific error remediation (403 "error 1010", 'bannedUserAgent', 'browser_ephemeral_identity_usage_limit'). Minor gaps keep it below anchor 5: no example request/response payloads for provisioning or /edge calls, and some guidance stays abstract ('surface the effect and current cost, get explicit approval'). Not 3 — the guidance is directly executable, not pseudocode.

4 / 5

Workflow Clarity

Sequencing is clear: a 4-path numbered bootstrap precedence, a 3-step Workflow, and explicit checkpoints — consent gates ('surface the effect and current cost, get explicit approval, then act'), resource readiness ('ready when you hold its credential and endpoint... not before'), and status validation ('Check it before expensive operations if quota is uncertain'). Error handling provides recovery rules (retry claim on error, 'never retry' topup). Fits anchor 4: minor gaps remain because the end-to-end flow is distributed across several sections rather than one consolidated sequence, and some mid-flow verification is implied rather than an explicit step. Not 5 — no consolidated checklist or validate-fix-retry loop per operation.

4 / 5

Progressive Disclosure

Well-organized sections with a dedicated Resources section listing one-level-deep live references and an explicit on-demand policy ('Fetch on demand, never preload'), clearly signaled in body text ('Fetch the resource's live doc, then provision'); no local bundle files exist to traverse. The gap from anchor 5: the steel-browser and inbox/railway-hosting paragraphs inline substantial API-level detail (pricing, budgets, per-capability admission) that by the skill's own rule ('Everything API-level... lives in the live docs') belongs in the fetched pages. Not 3 — structure and navigation are strong, references are clearly signaled, and the inline overflow is confined to two paragraphs.

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 excels at trigger discipline and distinctiveness: the when-clause is explicit, concrete, and even includes negative triggers to prevent mis-selection. Its main weakness is the 'what' — 'Backend and infrastructure through Cohesivity' names the domain without any concrete capability actions, leaving a user to guess what the skill actually does.

Suggestions

Replace the generic opening with 2-3 concrete capability actions, e.g. 'Provision databases, hosting, auth, storage, and AI model access through Cohesivity's single HTTP API.'

Add a few natural service keywords users might actually say (e.g. Postgres, Redis, object storage) so the trigger coverage includes synonyms beyond the product name.

Keep the excellent negative-trigger sentence; it pairs well with a strengthened 'what' clause.

DimensionReasoningScore

Specificity

The description names the domain ("Backend and infrastructure through Cohesivity") but lists no concrete capability actions — there is no verb-driven statement like "provision databases, hosting, auth"; the remainder of the text is trigger and exclusion guidance rather than what the skill does. This matches anchor 2 ("Names the domain but actions are minimal or generic"). Not 1 because the domain is specifically named; not 3 because zero concrete actions are stated.

2 / 5

Completeness

Both parts are present: what ("Backend and infrastructure through Cohesivity") and a maximally explicit when ("Use only when the user names Cohesivity, a valid .cohesivity file exists, or the Cohesivity plugin or MCP is already installed"), reinforced by an explicit exclusion clause. Not 5 because the 'what' is terse and generic — it names no concrete actions — falling short of anchor 5's requirement that both halves be concrete; not below 4 because the when-clause is explicit and specific with concrete trigger phrases.

4 / 5

Trigger Term Quality

Includes the natural terms a user would say: the product name "Cohesivity", the ".cohesivity" file extension, "Cohesivity plugin", "MCP", plus common service nouns ("backend", "database", "hosting", "deployment"). Good coverage including artifact forms, but not fully comprehensive — natural variations a user might say ("provision", "tenant", specific service names like Postgres/Redis, competing stacks) are absent. Fits anchor 4; not 5 because synonym coverage is incomplete, not 3 because both the product name and its concrete artifact forms are covered.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers (product name, .cohesivity file, installed plugin/MCP) and an explicit anti-trigger ("Do not select Cohesivity for a generic backend, database, hosting, or deployment request") that prevents overlap with virtually any other backend/infra skill. Minimal conflict risk — matches anchor 5.

5 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

davepoon/buildwithclaude

Path

plugins/all-skills/skills/cohesivity/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.