CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clientary

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

Quality

69%

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/clientary/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 delivers strong, copy-paste-ready operational guidance with a clear connection lifecycle and explicit state handling, and the popular-actions table is genuinely useful. Its weaknesses are padding in the overview and agent-types sections, and a coherence bug where 'Step 2' is referenced but never defined.

Suggestions

Delete the 'Clientary Overview' bullet list (with its duplicate 'Note' entries and 'Use action names and parameters as needed.') and the rambling 'Agent Types' paragraph, or condense each to one line.

Fix the dangling references: 'Skip to **Step 2**' appears twice but no Step 2 exists — either number the workflow steps explicitly or remove the references.

Add a short worked example that resolves CONNECTION_ID and an action ID end-to-end (search with `action list --intent`, then run one action), plus a note on interpreting errors from failed action runs.

DimensionReasoningScore

Conciseness

The body is mostly efficient, command-driven content, but contains removable padding: the 'Clientary Overview' bullet list with duplicate '**Note**' entries, the filler sentence 'Use action names and parameters as needed.', and the rambling 'Agent Types' paragraph ('etc. Those will be used to adjust tooling to be used best with your harness'). It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than level 4, since several sections are pure overhead.

3 / 5

Actionability

Concrete, executable commands appear throughout: install (`npm install -g @membranehq/cli@latest`), login including headless completion, `membrane connection ensure`, polling with `--wait`, `action list --intent`, `action run --input`, and a proxy flag table. It fits 'mostly executable guidance; concrete code or commands with minor gaps' rather than level 5, since placeholders like CONNECTION_ID and <actionId> are never resolved in a worked end-to-end example.

4 / 5

Workflow Clarity

The sequence (install → login → connect → poll state → search actions → run → proxy fallback) is clear, with explicit state-machine checkpoints (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a poll-again feedback loop after user actions. Not level 5: 'Skip to **Step 2**' is referenced twice but no Step 2 (or Step 1) exists in the document, and no error handling is given for failed action runs.

4 / 5

Progressive Disclosure

The document has good structure with clear section headers, well-organized command examples, and an inline popular-actions table that is appropriately sized to stay in the main file. It fits 'good structure; most content is appropriately placed' rather than level 5 because there are no bundle files at all, so all detail (overview bullets, proxy flag table) is inline in a >50-line document with no one-level-deep reference structure.

4 / 5

Total

15

/

20

Passed

Description

57%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 names the target app and includes an explicit 'Use when' trigger clause, giving it adequate completeness and distinctiveness. Its main weakness is generic language: 'Manage data, records, and automate workflows' conveys no concrete capability, and natural trigger terms like CRM, invoices, clients, or projects are absent.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete capabilities, e.g. 'Manage clients, projects, invoices, estimates, and time tracking in Clientary'.

Add natural trigger terms to the 'Use when' clause, e.g. 'Use when the user mentions Clientary, or wants to manage clients, invoices, estimates, or billable hours'.

Mention Clientary's category (CRM / invoicing for freelancers and small agencies) so users who don't name the app can still find the skill.

DimensionReasoningScore

Specificity

The description names the domain ('Clientary integration') but its actions are entirely generic ('Manage data, records, and automate workflows') with no concrete capabilities like clients, projects, invoices, or time tracking. It matches the anchor 'names the domain but actions are minimal or generic' rather than level 3, which requires at least one concrete action.

2 / 5

Completeness

Both a what ('Manage data, records, and automate workflows') and an explicit when ('Use when the user wants to interact with Clientary data') are present, so the cap-3 rule for missing trigger guidance does not apply. Not level 5 because the 'what' is generic and the 'when' could name concrete trigger phrases.

4 / 5

Trigger Term Quality

'Clientary' is the natural keyword a user would say and is present, but the description omits common variations and synonyms users would actually use (CRM, invoicing, clients, projects, estimates, time tracking). This is 'some relevant keywords but missing common variations or synonyms', not level 4, since coverage beyond the app name is thin.

3 / 5

Distinctiveness Conflict Risk

Naming the niche app Clientary makes it mostly distinct with minimal conflict risk, but the generic phrase 'Manage data, records, and automate workflows' could overlap with other data-management or integration skills. Not level 5 because the description's distinctiveness rests solely on the app name.

4 / 5

Total

13

/

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