CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clio-manage

Clio integration. Manage Recordses. Use when the user wants to interact with Clio 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

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/clio-manage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 content delivers genuinely executable CLI guidance with strong error-state handling for connection setup, but it is weakened by a broken step-numbering scheme (references to nonexistent Step 2 / 1b), a duplicated discovery command, and a "Popular actions" section that lists no actual actions. Structure and single-file organization are solid for a skill of this size.

Suggestions

Fix the workflow numbering: either introduce explicit numbered steps (Step 1a install/auth, Step 2 discover and run actions) or remove the dangling "skip to Step 2" / "1b" references.

Make "Popular actions" earn its place — list a few concrete, commonly used Clio actions with example invocations, or delete the section and keep only the single discovery command in "Searching for actions".

Tighten "Best practices" and the connection narrative to remove guidance already stated earlier (prefer Membrane, discover before building), reducing duplication.

DimensionReasoningScore

Conciseness

The body is mostly tight command examples, but "Popular actions" duplicates the discovery command already given in "Searching for actions", "Best practices" restates earlier guidance, and filler like "This is the fastest way to get a connection" pads the text — matching anchor 3 'Mostly efficient but includes some unnecessary explanation or could be tightened'. Not 4 because the duplication is a clear instance of removable content, not a minor trim.

3 / 5

Actionability

Concrete copy-paste commands cover install, login (including headless completion), connection ensure/poll, action list/run with JSON input, and proxy usage with a full flag table — anchor 4 'Mostly executable guidance'. Not 5 because no concrete example action id or realistic input/output is shown, and the "Popular actions" header promises actual actions but delivers only the generic discovery command.

4 / 5

Workflow Clarity

The install → auth → connect → poll → search → run → proxy sequence is present with good state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with follow-up actions), but the body says "skip to **Step 2**" and numbers a section "1b" while no Step 1a or Step 2 exists anywhere — incoherent sequencing that matches anchor 3 'Steps listed but sequence has gaps'. Not 4 because the dangling step references break the navigational chain of the workflow.

3 / 5

Progressive Disclosure

The single-file body (~135 lines) is organized into clear sections (Overview, Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no nested or buried references — anchor 4 'Good structure; most content is appropriately placed'. Not 5 because minor gaps remain (the placeholder "Popular actions" section adds no structure value, and section numbering is inconsistent), though nothing clearly belongs in a separate file.

4 / 5

Total

14

/

20

Passed

Description

61%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 has an explicit and well-scoped 'Use when' trigger tied to the distinct Clio brand, but its 'what' is weak: the only capability stated is the generic, typo-damaged "Manage Recordses". Trigger coverage relies solely on the brand name with no domain synonyms or concrete operations.

Suggestions

Fix the typo "Recordses" and enumerate the concrete operations, e.g. "Create, read, update, delete, and list Records (matters, contacts, documents, time entries) in Clio Manage."

Add natural trigger terms and synonyms users would actually say, such as "Use when the user mentions Clio, Clio Manage, legal matters, contacts, or time entries."

State what the integration covers end-to-end (data operations via pre-built actions and direct API proxy) so the 'what' is as explicit as the 'when'.

DimensionReasoningScore

Specificity

"Clio integration. Manage Recordses." names the domain but offers only the generic (and typo-damaged) verb "Manage" with no concrete operations, matching the anchor 'Names the domain but actions are minimal or generic'. It is not a 3 because no concrete actions (e.g. create, read, update, delete, list) are stated.

2 / 5

Completeness

Both a 'what' ("Clio integration. Manage Recordses.") and an explicit 'when' ("Use when the user wants to interact with Clio data") are present, matching anchor 4's pattern. Not 5 because the 'what' is thin and generic rather than concretely describing capabilities; not 3 because the when-clause is explicit rather than missing or implied.

4 / 5

Trigger Term Quality

The description includes the natural keyword "Clio" ("interact with Clio data"), but provides no synonyms or common Clio-domain terms (matters, contacts, documents, time entries, billing), matching 'Some relevant keywords but missing common variations or synonyms'. Not a 4 because coverage beyond the single brand name is absent.

3 / 5

Distinctiveness Conflict Risk

Clio is a specific product niche and the trigger ("Use when the user wants to interact with Clio data") is brand-specific, giving a clear niche with minimal conflict risk with other skills — anchor 5. No neighboring anchor fits better since generic overlap is essentially absent.

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