CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cacoo

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

Quality

68%

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/cacoo/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 solid, command-driven integration skill: nearly everything is an executable Membrane CLI instruction with good state-handling detail for connection setup. The main weaknesses are a dangling "Step 2" reference from an abandoned numbering scheme, no concrete worked example of an actual Cacoo action, and light padding around the Membrane framing.

Suggestions

Fix the dangling references: "skip to **Step 2**" points to a step that does not exist — either introduce explicit numbered step headings (Step 1: Connect, Step 2: Discover actions, Step 3: Run) or remove the mentions.

Add one worked end-to-end example under Running actions, e.g. `membrane action list --connectionId=... --intent "list diagrams" --json` followed by running the returned action id for a common Cacoo task like fetching or creating a diagram.

Trim the padding: the opening paragraph explaining what Cacoo is and the agent-types enumeration line can be reduced to a few tokens without losing actionable content.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands and a compact flag table, but includes minor padding such as "Cacoo is a user-friendly online diagramming tool. It's used by teams to collaborate..." and the agent-types list "claude, openclaw, codex, warp, windsurf, etc." that could be trimmed. Not 3 because the bulk is lean CLI instruction rather than explanation of known concepts; not 5 because the intro paragraph and Membrane marketing framing ("This is the fastest way to get a connection. The URL is normalized to a domain...") slightly over-explain.

4 / 5

Actionability

Concrete, copy-paste-ready commands cover install ("npm install -g @membranehq/cli@latest"), auth ("membrane login --tenant --clientName=<agentType>"), connection ("membrane connection ensure \"https://cacoo.com/\" --json"), action discovery/run, and proxy flags. Not 5 because there is no worked example of a real Cacoo action (e.g., searching "list diagrams" and running a concrete actionId) — every invocation uses placeholders like CONNECTION_ID and <actionId> without a demonstrated end-to-end case.

4 / 5

Workflow Clarity

A clear sequence is present (install → login → connection ensure → poll state → search actions → run / proxy) and the connection phase has genuine validation checkpoints (polling until state leaves BUILDING, explicit READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR handling and re-poll after user action). Not 5 because "skip to **Step 2**" is referenced twice but no Step 1/Step 2 headings exist (a dangling, incoherent reference), and running actions has no error-checking or output-validation guidance.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the body is reasonably well organized into clearly headed sections (Overview, Working with Cacoo, Popular actions, Best practices) with no nested or broken file references. Scored 4 rather than 5 because at ~145 lines the Cacoo overview entity tree and proxy flag table could partly live in a reference file, and the stray numbered-step convention ("1b", "Step 2") muddies navigation slightly.

4 / 5

Total

16

/

20

Passed

Description

48%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 answers "when" explicitly via a "Use when..." clause and anchors on a distinctive app name, but its "what" is generic filler — "manage data, records, and automate workflows" describes almost any integration and never mentions that Cacoo is a diagramming tool. It is functional as a trigger but reads like boilerplate rather than a scoped capability statement.

Suggestions

Replace the generic "Manage data, records, and automate workflows" with Cacoo-specific concrete actions, e.g. "Create and edit diagrams, flowcharts, mind maps, and network diagrams; manage folders, projects, and team shares in Cacoo."

Add the natural trigger terms users would say — "diagram", "flowchart", "mind map", "wireframe" — to the "Use when" clause so the skill triggers even when the user does not name Cacoo explicitly.

Ground the description in the diagramming domain so it cannot be confused with generic data-integration skills.

DimensionReasoningScore

Specificity

"Cacoo integration" names the domain, but the stated actions — "Manage data, records, and automate workflows" — are minimal and generic boilerplate that never mentions diagrams, the actual capability domain. Not 3 because no concrete action (e.g., "create and edit diagrams" or "manage folders and projects") is listed; not 1 because the domain is named and third-person action verbs are used.

2 / 5

Completeness

It has an explicit "when" — "Use when the user wants to interact with Cacoo data" — but the "what" ("Manage data, records, and automate workflows") is vague boilerplate that does not concretely state what the skill does. Not 4 because anchor 4 requires a clear "what", and "manage data, records" could describe almost any data app; not 2 because the "when" clause is present and reasonably explicit.

3 / 5

Trigger Term Quality

"Cacoo" and "Cacoo data" are relevant, specific keywords a user would say when they need this skill, but all natural task-level terms users would actually use — diagram, flowchart, mind map, network diagram, wireframe — are missing. Not 4 because keyword coverage is essentially a single app name with no variation or synonym coverage; not 2 because "Cacoo" is a specific, genuinely natural trigger rather than a generic filler keyword.

3 / 5

Distinctiveness Conflict Risk

The Cacoo brand name gives it a clear niche and it will trigger correctly whenever the user mentions Cacoo, with minimal conflict risk against unrelated skills. Not 5 because the generic "Manage data, records, and automate workflows" phrasing creates minor overlap risk with other diagramming/data-app skills (Miro, Lucidchart, draw.io) whose descriptions could read nearly identically apart from the app name.

4 / 5

Total

12

/

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