CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

broadridge

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

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/broadridge/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 body delivers concrete, mostly copy-paste-ready CLI guidance with a genuinely well-handled connection polling/state workflow, but it is undermined by dangling step references ('Step 2' is never defined, '1b' has no '1a'), duplicated discovery commands, and an unnecessary company-background preamble. Structure is good for a single-file skill, though a couple of sections could be split out.

Suggestions

Fix the workflow numbering: define an explicit "Step 2" (or renumber 'Connecting to Broadridge' as Step 1 and 'Searching for actions' as Step 2) so the "skip to Step 2" and "1b" references resolve.

Cut the opening Broadridge company-bio paragraph and the duplicated `action list` command in 'Popular actions' — keep one canonical discovery example.

Consider moving the proxy flag table and the clientAction state-machine explanation into a reference file, keeping SKILL.md focused on the get-connected-and-act flow.

DimensionReasoningScore

Conciseness

The opening blurb ("Broadridge is a financial technology company providing investor communications... serve banks, broker-dealers, asset managers") is background Claude does not need, and the `action list` command appears twice ('Searching for actions' and 'Popular actions'). Fits anchor 3 (mostly efficient, some unnecessary explanation or could be tightened); not 4 because the company-bio paragraph and duplicated discovery section are clear trim targets, and not 2 because the bulk of the body is lean, executable CLI content.

3 / 5

Actionability

Commands are concrete and executable throughout (`npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://www.broadridge.com/" --json`, `membrane action run <actionId> --input '{"key": "value"}'`) with a complete proxy flag table. Fits anchor 4 (mostly executable, minor gaps); not 5 because the instruction "skip to **Step 2**" references a step that is never defined, leaving a real execution-path gap, and placeholders like CONNECTION_ID are never tied to where the value comes from beyond one mention.

4 / 5

Workflow Clarity

The connect → poll → act sequence exists and the connection state machine (READY / CLIENT_ACTION_REQUIRED with poll-again guidance) is a genuine checkpoint loop, but the workflow numbering is incoherent: "skip to **Step 2**" has no target, and "1b. Wait for the connection to be ready" sits under an unnumbered parent heading, so the intended step order must be inferred. Fits anchor 3 (sequence present but checkpoints/structure implicit); not 4 because the broken step references leave gaps in the defined sequence, and not 2 because a rough, mostly-followable sequence with state validation is present.

3 / 5

Progressive Disclosure

With no bundle files, the single-file body is well-organized into clear sections (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) at reasonable length. Fits anchor 4 (good structure, most content appropriately placed, minor gaps); not 5 because content like the proxy flag table and the clientAction state-machine explanation are candidates for a reference file that would keep SKILL.md a leaner overview, and not 3 because nothing is buried and navigation is easy.

4 / 5

Total

14

/

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 has an explicit 'Use when...' trigger and names a distinct niche (Broadridge), but the capability half is generic filler ('manage data, records, and automate workflows') with no concrete actions or Broadridge-specific terminology. It would rarely trigger for the wrong skill, but a user describing a task in domain terms (e.g., 'investor communications') would not find it.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with 2-3 concrete Broadridge-specific actions (e.g., 'Manage client onboarding, accounts, profiles, and documents; run workflows and tasks') drawn from the domain tree already listed in the body.

Broaden trigger terms beyond the brand name to include the natural phrases a user would say, e.g., 'Use when the user mentions Broadridge, investor communications, or client/account and document management for Broadridge.'

Tighten the pairing so the 'what' clause explicitly enumerates capabilities rather than restating 'Broadridge integration' vaguely.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Broadridge domain but every action is generic — nothing concrete like "fetch shareholder records" or "submit documents". Fits anchor 2 (domain named, actions minimal or generic); not 3 because no 1-2 concrete actions are actually specified, and not 1 because the domain is clearly named.

2 / 5

Completeness

Both parts are present: what ("Broadridge integration. Manage data, records, and automate workflows.") and an explicit when ("Use when the user wants to interact with Broadridge data."). Matches anchor 4 (both present, one could be more specific); not 5 because the 'what' half is vague about concrete capabilities, and not 3 because the 'when' clause is explicit rather than merely implied.

4 / 5

Trigger Term Quality

"Broadridge" / "Broadridge data" are natural user terms, but "data", "records", and "workflows" are generic filler with no synonyms for what users would actually say (investor communications, proxy, statements, .com APIs). Fits anchor 3 (some relevant keywords, missing common variations); not 4 because most of the keyword surface is non-discriminating boilerplate.

3 / 5

Distinctiveness Conflict Risk

"Broadridge" carves a clear niche with minimal conflict risk, but the generic "manage data, records, and automate workflows" half could overlap with many other data-integration skills. Fits anchor 4 (mostly distinct, minor overlap risk); not 5 because the generic action phrasing invites overlap when the user's request doesn't mention Broadridge by 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/broadridge/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.