CtrlK
BlogDocsLog inGet started
Tessl Logo

element

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

54

Quality

61%

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/element/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, with concrete executable commands and a clear connection-state feedback loop. Its main weaknesses are minor: a broken "Step 2" reference in the workflow, light redundancy between the search and popular-actions sections, and no external reference split for the proxy options.

DimensionReasoningScore

Conciseness

The body is mostly lean command-based guidance, with only minor over-explanation that could be trimmed (the "what Element is" opener and "so you can focus on the integration logic rather than auth plumbing").

4 / 5

Actionability

It provides copy-paste-ready commands for the common cases — install, login (incl. headless), connection ensure, polling get, action list/run with JSON input, and proxy requests with a full flag table — covering the workflow comprehensively.

5 / 5

Workflow Clarity

The install→auth→connect→poll→search→run sequence is clear with an explicit polling feedback loop and state checks (READY/CLIENT_ACTION_REQUIRED), but the "skip to Step 2" reference points to a non-existent labeled step and the numbering is inconsistent.

4 / 5

Progressive Disclosure

The single self-contained file is well-organized with clear section headers and no nested references, but at ~140 lines with no external file split (e.g., the proxy flag reference) it sits just below the cleanly-split anchor 5.

4 / 5

Total

17

/

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 a specific app and includes a Use-when clause, but its capability statement is generic and its trigger terms omit the natural keywords (rooms, messages, chat) users would say. It is distinct as an Element-specific skill yet thin on specifics.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete Element actions such as sending messages, managing rooms, and looking up users.

Expand the trigger clause to include natural phrases users actually say, e.g. "Use when the user wants to send or read Element messages, manage rooms, or work with Element chat data."

Tighten the opening "Element integration." into the action list so the what reads as capabilities rather than a label.

DimensionReasoningScore

Specificity

The description names the domain (Element) but its actions are minimal and generic — "Manage data, records, and automate workflows" describes no concrete Element capability (rooms, messages, users) and reads like padding.

2 / 5

Completeness

A "Use when..." clause is present (so not capped at 3 by its absence), but the "what" is vague ("Manage data, records, and automate workflows") and the "when" lacks concrete trigger phrases, leaving it below the both-clear anchor 4.

3 / 5

Trigger Term Quality

The only trigger is "Use when the user wants to interact with Element data," a single generic phrase; the natural terms users would actually say (messages, rooms, chat, teams) are missing.

2 / 5

Distinctiveness Conflict Risk

"Element" is a specific named app with an explicit Element-data trigger, making it mostly distinct with only minor overlap risk against closely related messaging/collaboration skills (Slack, Teams).

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.

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.