CtrlK
BlogDocsLog inGet started
Tessl Logo

polymer

Polymer integration. Manage data, records, and automate workflows. Use when the user wants to interact with Polymer 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/polymer/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 content is a well-structured, command-heavy integration guide with real validation feedback loops in the connection workflow. Its main weakness is coherence and conciseness: the intro and overview describe the wrong 'Polymer' (the web-components library) and explain concepts Claude already knows, and a 'Step 2' is referenced but never defined.

Suggestions

Remove or replace the JS-library intro paragraph and the polymer-project.org docs link; open instead with what the Polymer data product is and that this skill drives it via the Membrane CLI.

Delete or explain the bare 'Document / Page / Element / Style / Theme' overview tree and the 'Use action names and parameters as needed' line, which add tokens without actionable guidance.

Fix the broken cross-reference: either label the action-discovery section 'Step 2' or reword 'skip to Step 2' to point to the actual heading ('Searching for actions').

DimensionReasoningScore

Conciseness

The bulk of the Membrane CLI instructions is efficient and code-driven, but the opening paragraph explains what the Polymer JS library is ('a Javascript library for creating custom HTML elements...') — a concept Claude already knows and, notably, the wrong product — plus a vague 'Polymer Overview' tree. It is not a 4 because these padded/explanatory sections are noticeable, and not a 2 because most of the body is tight and command-oriented.

3 / 5

Actionability

It provides concrete, executable commands throughout (install, login, connection ensure, action list/run, request) plus a flags table. It is not a 5 because commands rely on unsubstituted placeholders (CONNECTION_ID, QUERY, <actionId>) and the 'Polymer Overview' gives only the vague directive 'Use action names and parameters as needed', and not a 3 because the guidance is genuinely executable rather than pseudocode.

4 / 5

Workflow Clarity

The connection flow is clearly sequenced with state-based validation checkpoints and feedback loops (poll until READY, handle CLIENT_ACTION_REQUIRED, check error fields). It is not a 5 because the body references 'Step 2' which is never labeled, and the JS-library intro is incoherent with the actual data-product workflow; not a 3 because explicit validation and retry loops are present.

4 / 5

Progressive Disclosure

With no bundle files present, the single SKILL.md is organized into clear headed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices). It is not a 5 because it exceeds the simple-skill line and contains organizational noise (the wrong-product docs link and the unexplained Document/Page/Element/Style/Theme tree), and not a 3 because structure is genuinely good.

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 answers both 'what' and 'when' with an explicit trigger clause and is tied to a named product, but its capability list is generic and trigger-term variety is thin. Specificity is the main weakness, since 'manage data, records, and automate workflows' could describe almost any data tool.

Suggestions

Replace the generic verbs with concrete actions the integration actually performs (e.g., 'search records, filter datasets, run saved views, update rows') so the 'what' is specific.

Add natural trigger synonyms and file/entity terms users would say (e.g., 'Polymer tables', 'Polymer dashboards', 'Polymer datasets') to broaden trigger coverage beyond the product name.

Disambiguate from the Polymer web-components library by anchoring the description to the data product (e.g., 'Polymer (polymersearch.com) data integration').

DimensionReasoningScore

Specificity

The description names the domain ('Polymer integration') but the listed actions ('Manage data, records, and automate workflows') are generic and abstract rather than concrete, matching the anchor 'Names the domain but actions are minimal or generic'. It is not a 3 because no concrete, specific action (akin to 'extracts content') is stated.

2 / 5

Completeness

It explicitly answers both 'what' ('Manage data, records, and automate workflows') and 'when' ('Use when the user wants to interact with Polymer data'). It is not a 5 because the 'what' is vague rather than concrete, and not a 3 because the 'when' is explicit rather than missing or weakly implied (so the missing-trigger cap does not apply).

4 / 5

Trigger Term Quality

It includes relevant keywords ('data', 'records', 'workflows', 'Polymer data') and an explicit trigger ('Use when the user wants to interact with Polymer data'), but coverage relies on the product name and misses common variations or synonyms. It is not a 4 because natural phrasing variety is thin, and not a 2 because several relevant terms are present.

3 / 5

Distinctiveness Conflict Risk

Tying triggers to a named product ('Polymer data') gives it a mostly distinct niche with minor overlap risk. It is not a 5 because 'Polymer' is also a well-known web-components library, creating some ambiguity, and not a 3 because the data-oriented triggers keep it reasonably distinguishable.

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.