CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brikl

Brikl integration. Manage data, records, and automate workflows. Use when the user wants to interact with Brikl 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/brikl/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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, executable CLI guidance with a well-handled connection state machine, and most sections earn their tokens. Its main flaws are the large auto-generated-looking entity list that pads the context window, broken step cross-references, and the absence of any progressive-disclosure structure despite the length.

Suggestions

Delete or drastically prune the 'Brikl Overview' bullet list — the trailing generic verbs (List, Get, Create, Update, Delete, etc.) add pure token cost; if the entity taxonomy matters, move it to a references/ file.

Fix the step numbering: either label the sections 'Step 1 / Step 2' so 'skip to Step 2' resolves, or rewrite those cross-references as section names; also rename '1b' since no '1a' exists.

Add one concrete end-to-end example with real values (e.g. an actual action list query and run for a common task like listing products) and settle on a single CLI invocation form.

DimensionReasoningScore

Conciseness

The CLI instructions are efficient and command-driven, but the ~50-item 'Brikl Overview' bullet list is substantial padding — its trailing entries ('List', 'Get', 'Create', 'Update', 'Delete', 'Calculate', 'Validate') are generic verbs conveying no information. This is more over-padding than the minor-trimmable level of 4, but only one major padded section plus a two-sentence (defensible, since Brikl is niche) intro, so not the several-padded-sections level of 2.

3 / 5

Actionability

Concrete, executable commands throughout — 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.brikl.com/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {"key": "value"} --json' — plus a complete proxy flag table. Not 5 because every example is placeholder-only with no end-to-end worked example, and CLI invocation is inconsistent (bare 'membrane' vs 'npx @membranehq/cli').

4 / 5

Workflow Clarity

The install → login → connection → poll → search → run → proxy sequence is clear, and the connection-state handling (READY / CLIENT_ACTION_REQUIRED with clientAction fields / CONFIGURATION_ERROR with error field) provides an explicit validation loop. Not 5 because step numbering is incoherent: 'skip to Step 2' is referenced twice but no Step 2 heading exists, and a '1b' section appears without a corresponding labeled Step 1.

4 / 5

Progressive Disclosure

The skill has no bundle files and no external references; the ~185-line body is reasonably sectioned for CLI usage, but the 50-item entity list is low-value inline content that belongs in a separate reference file (or nowhere). This matches 'content that should be separate is inline / could be better organized' at 3; it does not reach 4's 'most content is appropriately placed' given how much of the body that list occupies, and the under-50-line simple-skill exception does not apply.

3 / 5

Total

14

/

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 follows the what/when structure with a distinctive proper-noun trigger, but its capability statement is generic. 'Manage data, records, and automate workflows' could describe almost any integration skill and gives Claude little basis for knowing what Brikl tasks it can actually perform.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with 2-3 concrete capabilities drawn from the body, e.g. 'Manage Brikl products, price breaks, orders, and team stores via the Membrane CLI'.

Broaden the trigger terms beyond 'Brikl data' to include natural variations users would say — e.g. 'Use when the user mentions Brikl, Brikl stores, orders, quotes, or team stores'.

Remove the buzzword 'automate workflows', which over-claims without naming any actual workflow.

DimensionReasoningScore

Specificity

The description names the domain ('Brikl integration') but its actions — 'Manage data, records, and automate workflows' — are generic and buzzwordy, closely matching the 'Processes data' bad-example pattern rather than any concrete capability. It is above 1 because the domain is named with multiple listed actions, but below 3 because none of those actions is concrete.

2 / 5

Completeness

Both a 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Brikl data') are present, which rules out scores 1-3; however the 'what' is vague rather than concrete and the 'when' is narrow, so it does not reach the 5 anchor's clearly-concrete standard. Score 4 fits: both present, each could be more explicit.

3 / 5

Trigger Term Quality

'Brikl' and 'interact with Brikl data' are natural, distinctive keywords a user would actually say, but coverage stops there — no common variations or synonyms such as Brikl store, products, orders, team stores, or quotes. This sits between the one-or-two-generic-keywords anchor (2) and good keyword coverage (4).

3 / 5

Distinctiveness Conflict Risk

'Brikl' is a distinctive proper-noun niche with an explicit trigger ('Use when the user wants to interact with Brikl data'), making false-trigger conflict with other skills very unlikely. It clearly matches the clear-niche/minimal-conflict anchor rather than the minor-overlap anchor at 4.

5 / 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/brikl/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.