channel-matrix

Matrix/Element messaging channel for Clawdbot agent

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/channels/matrix/SKILL.md

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is appropriately concise and well-structured for a simple skill, but it stops at setup and never instructs Claude on how to actually launch or use the channel, which limits actionability and workflow clarity.

Suggestions

Add a runnable invocation example, e.g. `python scripts/channel.py --homeserver … --access-token … --room-id …`, or note that the host runtime launches it via the frontmatter capability.

Include a short usage/commands section documenting the stdin JSON protocol (send/send_file/react/stop) the script expects, drawing from scripts/channel.py.

Add a readiness/validation checkpoint, e.g. confirm the `ready` event is emitted before sending, to sequence the channel lifecycle.

Dimension	Reasoning	Score
Conciseness	The body is lean and efficient — a one-line orientation and an executable setup block — with no padding or explanation of concepts Claude already knows.	3 / 3
Actionability	The setup commands are concrete and executable, but the body never shows how to run scripts/channel.py or gives an example of invoking the supported actions, leaving the core usage incomplete.	2 / 3
Workflow Clarity	Only a single setup step is presented; the run/operate workflow for the channel is absent and there is no validation or readiness checkpoint before going live.	2 / 3
Progressive Disclosure	This is a simple under-50-line skill organized into a clear Setup section, with the one bundle file (scripts/channel.py) referenced one level deep via the frontmatter — meeting the simple-skill bar for progressive disclosure.	3 / 3
	Total	10 / 12 Passed

Description

57%

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 identifies a clear, distinctive niche but is thin: it names the domain without listing concrete actions and omits any explicit when-to-use trigger, leaving it at the mid-band for most dimensions.

Suggestions

Add concrete actions to the description, e.g. "send messages, files, and reactions; edit, delete, and thread replies in a Matrix room".

Append an explicit trigger clause such as "Use when connecting Clawdbot to Matrix/Element, or when the user mentions Matrix, Element, or messaging-channel setup."

Include natural term variations users might say ("Matrix", "Element", "messaging channel", "room") to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ("Matrix/Element messaging channel") but lists no concrete actions — the supported actions (send, react, edit, etc.) appear only in the frontmatter capabilities, not the description.	2 / 3
Completeness	It states what the skill is but provides no "Use when…" or equivalent trigger guidance, which caps completeness at 2 per the rubric guidelines.	2 / 3
Trigger Term Quality	It includes natural terms users would say ("Matrix", "Element") but misses common variations and any explicit use-trigger phrasing.	2 / 3
Distinctiveness Conflict Risk	It targets a clear niche — a Matrix/Element channel for the specific Clawdbot agent — making conflict with other skills unlikely.	3 / 3
	Total	9 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: SharpAI/DeepCamera
Path: skills/channels/matrix/SKILL.md
Commit: 2264fcb

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.