CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clio

Clio integration. Manage Matters, Contacts, Tasks, Events, Bills, Users. Use when the user wants to interact with Clio data.

Quality

78%

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/clio/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 well-structured, command-driven integration guide: setup, discovery, execution, and proxy escape-hatch are all covered with concrete, copy-paste-ready CLI invocations and useful best practices. Weaknesses are minor — some low-value overview content, no end-to-end worked action example, and no explicit validation checkpoints after connection or write operations.

Suggestions

Replace the nested 'Clio Overview' tree and the filler line 'Use action names and parameters as needed.' with a compact entity list or move it to a reference file.

Add one worked example, e.g., `membrane action run --connectionId=... list-matters --json`, showing how a Popular-actions Key maps to ACTION_ID.

Add a validation step after connecting (e.g., run a cheap list action to confirm the connection works before proceeding).

DimensionReasoningScore

Conciseness

The body is dominated by executable commands and compact tables with minimal padding. Minor trimmable content: the background sentence "Clio is a legal practice management software...", the confusingly nested "Clio Overview" tree, and the filler line "Use action names and parameters as needed." — fitting anchor 4 ("minor instances of over-explanation that could be trimmed") rather than 5, and not 3 because the bulk is tight and instructional.

4 / 5

Actionability

Concrete copy-paste commands with placeholders throughout ("npm install -g @membranehq/cli", "membrane connect --connectorId=CONNECTOR_ID --json", "membrane request CONNECTION_ID /path/to/endpoint") plus a flags table and JSON-input example. Not a 5 because there is no fully worked `action run` example using a real action key, and the mapping between the Popular-actions "Key" column and ACTION_ID is left implicit; clearly above 3 since guidance is executable rather than pseudocode.

4 / 5

Workflow Clarity

The setup flow is clearly sequenced — install → login (with an explicit headless fallback) → connect → check existing connections → discover actions → run — with error-path handling. Minor validation gaps: no step verifies the connection/auth succeeded before running actions, and no post-run verification for create/update actions, which keeps it at anchor 4 rather than 5; well above anchor 3's missing-checkpoint profile.

4 / 5

Progressive Disclosure

A single-file skill (no references/, scripts/, or assets/ exist) with clear section headers and no nested references. Structure is good, but the ~20-row Popular-actions table and the proxy flags reference are reference-file candidates in a 140+ line body, matching anchor 4 ("most content is appropriately placed; minor organization gaps") rather than the well-signaled one-level references of a 5.

4 / 5

Total

16

/

20

Passed

Description

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

A solid description with an explicit 'Use when...' clause, good natural entity keywords, and clear product-level distinctiveness. Its main weakness is the single generic verb "Manage", which lists data objects rather than concrete capabilities, and a 'when' clause that could name more legal-domain trigger scenarios.

Suggestions

Replace the umbrella verb 'Manage' with concrete actions, e.g., 'Create, update, and list Matters, Contacts, Tasks, Events, Bills, and Users in Clio'.

Broaden the 'Use when' clause with natural legal-domain triggers such as 'law firm management', 'legal cases or matters', 'time tracking and billing in Clio'.

DimensionReasoningScore

Specificity

"Manage Matters, Contacts, Tasks, Events, Bills, Users" names the domain and a broad set of entities, but the only action verb is the generic "Manage" — matching the anchor "Names domain and 1-2 concrete actions, but not comprehensive". It is not a 4 because no distinct concrete actions (create, update, list, bill) are enumerated, only one umbrella verb applied to nouns.

3 / 5

Completeness

Both parts are explicitly present: the what ("Manage Matters, Contacts, Tasks, Events, Bills, Users") and the when ("Use when the user wants to interact with Clio data"). Not a 5 because the 'when' clause is generic and lacks concrete trigger phrases; not a 3 because an explicit 'Use when...' clause exists alongside a clear 'what'.

4 / 5

Trigger Term Quality

"Clio" plus the natural entity terms "Matters, Contacts, Tasks, Events, Bills, Users" give good keyword coverage a Clio user would actually say. Not a 5 because common legal-domain synonyms and variations (e.g., "cases", "law firm", "legal billing", "time tracking") are missing; not a 3 because coverage goes well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

"Clio integration" and the product-specific trigger "interact with Clio data" establish a clear niche with distinct triggers and minimal conflict risk against other skills. Re-checking the level below (4, "minor overlap risk with closely related skills") — the only overlap would be another Clio-specific skill, and the named-product trigger keeps it clearly distinct.

5 / 5

Total

16

/

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