CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

slack

Load to bind an overseer's mailbox to a private Slack channel, run or check the relay, or post an alert or a file to Slack.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

90%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.

An exemplary instruction-skill body: lean, fully actionable via a complete CLI synopsis, with explicit status/validation mechanisms and keyed error handling. The residual weaknesses are two bundle-relative links that do not resolve against the shipped files and validation guidance that is distributed across rules rather than presented as a sequenced workflow.

Suggestions

Ship `schemas/journal.md` and `kendex.settings.toml.example` in the bundle (or correct their paths) so the § links resolve for the reader.

Add a short numbered setup flow (install → setup → listen) with a `listen --status` checkpoint after each step.

Move the per-field `read` output line format and doctor row field list into a reference file to slim the body further.

DimensionReasoningScore

Conciseness

The body defers all per-verb detail to "slack --help" and every rule carries only operational facts (keyed refusals, exit codes, the 12,000-character cap, mrkdwn escaping). No concept Claude already knows is explained and no section is padded — every token earns its place.

5 / 5

Actionability

The opening block gives a complete executable CLI synopsis with every flag for all six verbs, and rules name concrete commands ("run `slack setup` for each bound root", "`lane-mail send --delivery-id`") plus concrete outcomes (`text-too-long`, exit 0, exit 2). This is copy-paste-ready guidance covering the common cases, matching the 5 anchor; it is not a 4 because no guidance is merely high-level.

5 / 5

Workflow Clarity

The setup → listen → post sequence is clear from the synopsis and Rules, and validation exists via "slack listen --status" with "state=ok|failing|stale|never" and `fix=` plus retry-on-next-poll and `already_reacted` settlement. It is not a 5 because the checkpoints are scattered across rules rather than laid out as a sequenced flow with feedback loops, and not a 3 because explicit status/validation and error-recovery behavior are present.

4 / 5

Progressive Disclosure

Sections (Rules / Message standard / Doctor row) are well organized, references are clearly signaled with section anchors, and the primary disclosure runs through the real `scripts/slack` entry point. It is not a 5 because two referenced paths — [schemas/journal.md](schemas/journal.md) and [kendex.settings.toml.example](kendex.settings.toml.example) — do not exist in the provided bundle, and detailed output-format specs (the `read` line format, doctor row fields) are inlined rather than split out.

4 / 5

Total

18

/

20

Passed

Description

78%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.

A strong description: specific, third-person, concrete actions with an explicit "Load to" trigger construction and a clear Slack niche. The main gaps are missing coverage of the read/compact/install verbs and the absence of natural synonyms (send, message, notify) and a fuller "Use when the user mentions..." clause.

Suggestions

Add an explicit trigger clause such as "Use when the user asks to send a message, alert, or file to Slack, or to set up or check the Slack relay".

Include natural synonyms like "send", "message" or "notify" alongside "post" to widen trigger-term coverage.

Consider naming the read capability (reading channel history) so the description covers all main verbs.

DimensionReasoningScore

Specificity

"bind an overseer's mailbox to a private Slack channel, run or check the relay, or post an alert or a file to Slack" lists several concrete actions (bind, run, check, post alert, post file). It falls short of the 5 anchor because the read, compact and install capabilities from the CLI are not represented in the description.

4 / 5

Completeness

The "what" is answered concretely with multiple actions, and the "when" is present via the explicit "Load to..." trigger construction enumerating each situation. It is not a 5 because there is no separate "Use when the user mentions/asks..." clause making the trigger conditions fully explicit, and not a 3 because equivalent explicit trigger guidance is stated.

4 / 5

Trigger Term Quality

"Slack", "private Slack channel", "relay", "post", "alert" and "file" are natural terms a user would say when needing this skill. It is not a 5 because common variations such as "send", "message" or "notify" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinctive: relaying "an overseer's mailbox to a private Slack channel" with "Slack" as the trigger term. Minimal overlap risk with any generic skill; no other skill would trigger for these requests.

5 / 5

Total

17

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 missing, 4 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

vanillagreencom/kendex

Path

skills/slack/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.