CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bridge

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

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/bridge/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 is a solid, command-driven integration guide with a well-handled connection-state workflow and concrete executable commands. Its main weaknesses are redundancy (auth explained three times, a duplicated action-discovery section that promises popular actions but lists none), dangling "Step 2" references, inconsistent CLI invocation styles, and an official-docs URL that points at a Trello API group instead of Bridge's API.

Suggestions

Either populate "Popular actions" with the actual top actions or merge it into "Searching for actions" to remove the duplicated `action list` guidance.

Fix the dangling "skip to Step 2" references and the lone "1b" heading by using consistent numbered steps or plain section names, and standardize on one CLI invocation (`membrane` vs `npx @membranehq/cli`).

Verify the official-docs link — it currently points to https://developer.atlassian.com/cloud/trello/rest/api-group-bridges/ (a Trello API group) rather than a Bridge API reference — and consolidate the three repeated explanations of Membrane's auth handling into one place.

DimensionReasoningScore

Conciseness

The body is mostly command-first and efficient, but has noticeable redundancy: Membrane's auth/credential handling is explained three times ("Working with Bridge", "Proxy requests", "Best practices"), and the "Popular actions" section merely repeats the `action list` command already shown in "Searching for actions" without listing any actions. This sits at 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the level-4 'minor instances' anchor.

3 / 5

Actionability

Concrete, copy-paste-ready CLI commands throughout (`npm install -g @membranehq/cli@latest`, `membrane connection ensure ... --json`, `membrane action run ... --input '{...}'`) plus a flags table for proxy requests — matches 'mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because the "Popular actions" heading lists zero actions, the CLI is invoked inconsistently (`membrane` vs `npx @membranehq/cli`), and the official-docs link points at a Trello API group rather than Bridge's API, weakening the self-serve lookup path.

4 / 5

Workflow Clarity

The connect-then-poll flow is a genuine sequenced workflow with a feedback loop: connection states (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR/SETUP_FAILED) each map to an explicit next action including re-polling after user action. Minor gaps keep it below 5: the text says "skip to Step 2" but no Step 2 heading exists (and there is a "1b" with no "1a"/numbered steps), and no guidance on handling failures from `action run`.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything lives in a single SKILL.md; it is organized into clear headed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) of appropriate length for an overview, matching 'good structure; most content is appropriately placed; minor organization gaps'. It is not a 5 because the entity-overview list and the proxy flags table are natural candidates for one-level-deep reference files in a larger bundle.

4 / 5

Total

15

/

20

Passed

Description

41%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 names the product but relies on template filler: no concrete capabilities, no natural trigger vocabulary beyond the proper noun 'Bridge', and a circular 'Use when' clause. Users would only match it by already naming Bridge, and the actual domain concepts (meetings, transcriptions, summaries, action items) that the skill body reveals are completely absent.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete capabilities drawn from the actual domain, e.g. 'Search and run actions on meetings, transcriptions, summaries, participants, action items, and analytics data'.

Rewrite the trigger clause with natural phrases users would say: 'Use when the user mentions Bridge, meetings, transcriptions, or wants to pull Bridge reports or records'.

State what the skill operationally is (a CLI-driven integration via the Membrane CLI) so the 'what' is substantive rather than circular.

DimensionReasoningScore

Specificity

"Bridge integration. Manage data, records, and automate workflows" names the domain but the actions are entirely generic — "manage data, records" and "automate workflows" name no concrete operations (no meetings, transcriptions, summaries, or records operations). This matches the anchor 'Names the domain but actions are minimal or generic' and falls short of level 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both parts are technically present — what: "Manage data, records, and automate workflows"; when: "Use when the user wants to interact with Bridge data" — but the 'what' is vague (no concrete capability) and the 'when' is circular, restating the product name rather than giving trigger phrases. This is weaker than anchor 4 ('both present, when could be more explicit') because the what itself lacks substance, so it lands at 3.

3 / 5

Trigger Term Quality

The only real keyword is the proper noun "Bridge"; the remaining terms ("data", "records", "workflows", "interact with Bridge data") are generic and miss the natural phrases a user would say (e.g., meetings, transcriptions, summaries, action items). It sits between 'one or two generic keywords' (2) and 'some relevant keywords but missing variations' (3), and since the keyword set is essentially one proper noun plus filler, 2 is the better fit.

2 / 5

Distinctiveness Conflict Risk

"Bridge integration" and "interact with Bridge data" give a clear niche trigger (the proper noun), so it is mostly distinct with only minor overlap risk against other SaaS-integration skills that follow the identical 'X integration. Manage data, records, and automate workflows' template. It does not reach 5 because the generic tail could still collide with sibling integration skills.

4 / 5

Total

11

/

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