CtrlK
BlogDocsLog inGet started
Tessl Logo

b-link

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

55

Quality

62%

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/b-link/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 concrete, executable Membrane CLI commands with a well-structured connection workflow and explicit state-based validation checkpoints. It loses points for some introductory concept padding and redundancy between the 'Searching for actions' and 'Popular actions' sections.

Suggestions

Trim the introductory 'B.Link is a URL shortener... used by marketers, businesses...' paragraph and the 'so you can focus on the integration logic rather than auth plumbing' aside, since Claude already understands these concepts.

Merge the thin 'Popular actions' section into 'Searching for actions' to remove the near-duplicate discovery command.

Add a brief verification step after running actions or proxy requests (e.g. checking the response `output`/error fields) to strengthen the workflow's feedback loop.

DimensionReasoningScore

Conciseness

The body is mostly efficient commands and a useful flag table, but includes unnecessary concept explanation ('B.Link is a URL shortener... used by marketers, businesses...') and padding ('so you can focus on the integration logic rather than auth plumbing'), fitting 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean score-4 anchor.

3 / 5

Actionability

It provides concrete, mostly copy-paste-ready commands throughout (install, login, connection ensure, action list/run, request) plus a flag table, but examples rely on placeholders (CONNECTION_ID, QUERY, <actionId>) and intent strings the agent must fill, matching 'mostly executable guidance; concrete code or commands with minor gaps' rather than fully self-contained score-5 examples.

4 / 5

Workflow Clarity

The connection flow is clearly sequenced with explicit state-based validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-after-action feedback loop, but action-running and proxy sections lack verification steps for confirming success, fitting 'clear sequence with most checkpoints present; minor validation gaps' rather than the score-5 checklist anchor.

4 / 5

Progressive Disclosure

As a single file with no bundle directories, content is well-organized into clearly headed sections (overview, install, auth, connecting, actions, proxy, best practices) with no nested references, fitting 'good structure; most content appropriately placed'; minor gaps like the redundant 'Popular actions' section versus 'Searching for actions' keep it below the score-5 anchor.

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 identifies the B.Link domain and includes both a what and a when clause, but its action list is generic Membrane boilerplate rather than link-specific capabilities. Trigger phrasing is explicit but lacks the natural terms (shorten, track, branded links) users would actually say.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete B.Link actions such as 'shorten links, track clicks, and create branded links'.

Make the 'Use when' clause enumerate natural triggers, e.g. 'Use when the user wants to shorten URLs, track link clicks, or manage branded links'.

Mention common synonyms/extensions users say (e.g. 'short URLs', 'link analytics', 'custom links') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("B.Link integration") but its actions are generic boilerplate ("Manage data, records, and automate workflows") rather than concrete link-management actions like shortening, tracking, or branding links, matching the 'names domain but actions are minimal or generic' anchor and falling below the score-3 anchor whose example lists concrete actions.

2 / 5

Completeness

Both a 'what' ("B.Link integration. Manage data, records, and automate workflows") and a 'when' ("Use when the user wants to interact with B.Link data") are present, but the 'when' is generic rather than concrete trigger phrases, matching 'has both what and when; when could be more explicit or specific' and not the score-5 anchor which requires concrete triggers.

4 / 5

Trigger Term Quality

It includes a relevant keyword ("B.Link") and a Use-when clause ("Use when the user wants to interact with B.Link data"), but misses the natural terms users would actually say (shorten links, track clicks, branded links, link analytics), fitting 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

Naming a specific product ("B.Link") gives it a clear niche with minimal conflict risk, though the generic Membrane boilerplate ('Manage data, records, and automate workflows') creates minor overlap with sibling integration skills, fitting 'mostly distinct; minor overlap risk with closely related skills'.

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.

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.