CtrlK
BlogDocsLog inGet started
Tessl Logo

clientary

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

58

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

The body is a strong, action-dense integration guide with executable commands and a well-sequenced connection workflow including polling checkpoints. Its main weakness is mild verbosity in the intro and best-practices prose, and a long inlined actions table that could be split into a reference file.

Suggestions

Trim marketing/informal prose (e.g. "so you can focus on the integration logic rather than auth plumbing", "burn less tokens") to tighten conciseness toward 4–5.

Move the 20-row popular-actions table into a references file (e.g. references/popular-actions.md) and keep only a few key examples inline, improving progressive disclosure.

Add a brief verification step after create/run actions (e.g. re-query the created resource or check the output field) to push workflow clarity toward 5.

DimensionReasoningScore

Conciseness

The body is mostly efficient — dominated by concrete commands and tables — but includes padding such as "so you can focus on the integration logic rather than auth plumbing" and "This will burn less tokens and make communication more secure", plus an introductory paragraph about what Clientary is. It is not 4 because several sentences are trimmable marketing/informal prose, and not 2 because the bulk is genuinely useful and direct.

3 / 5

Actionability

It provides fully executable, copy-paste-ready commands throughout (install, login, connection ensure/get, action list/run, request proxy) plus a concrete popular-actions table with real keys. This matches the top anchor of fully executable guidance covering common cases.

5 / 5

Workflow Clarity

The connection workflow is clearly sequenced with an explicit feedback loop (poll --wait, then branch on READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR and re-poll after the user acts). It does not reach 5 because there is no verification step after running or creating actions, and is above 3 because checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

Content is well-organized into clear sections (Overview, Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) with no nested references and no bundle files. It does not reach 5 because the 20-row popular-actions table is inlined monolithically where a one-level reference file could sit, keeping it just short of the cleanly-split top anchor.

4 / 5

Total

16

/

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 correctly includes an explicit "Use when..." trigger and names the distinct Clientary niche, but its capability list is generic. Tightening the vague actions into concrete operations (clients, projects, invoices, time tracking) would lift specificity and trigger coverage.

Suggestions

Replace generic actions ("Manage data, records, and automate workflows") with concrete Clientary operations such as creating clients/projects/invoices, tracking time, and managing estimates.

Expand trigger terms to include natural synonyms a user would say, e.g. "Use when the user wants to manage Clientary clients, projects, invoices, estimates, or tracked hours."

Keep the existing third-person voice and explicit "Use when..." clause, which already satisfy the completeness and voice requirements.

DimensionReasoningScore

Specificity

Names the Clientary domain but the actions ("Manage data, records, and automate workflows") are generic and minimal, with no concrete operations like creating invoices or tracking time. It does not reach 3 because it lists no specific concrete actions, and stays above 1 because it at least names the domain.

2 / 5

Completeness

It states both what ("Clientary integration. Manage data, records, and automate workflows.") and when ("Use when the user wants to interact with Clientary data."), with an explicit trigger clause so it is not capped at 3. It does not reach 5 because the "what" is vague and the "when" is generic rather than enumerating concrete trigger phrases.

4 / 5

Trigger Term Quality

The brand name "Clientary" and the phrase "interact with Clientary data" are natural trigger terms a user would say, but coverage lacks synonyms, related task terms, or file extensions. It does not reach 4 because common variations (e.g. clients, invoices, projects, time tracking) are absent, and is not 2 because the brand trigger is genuinely natural.

3 / 5

Distinctiveness Conflict Risk

"Clientary" is a specific named product, giving it a clear niche with distinct triggers and minimal conflict risk with other skills. It clearly matches the top anchor rather than 4, since the brand name is highly distinctive.

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.

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