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

75%

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 ./.agents/skills/slack/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A dense, highly actionable operator manual: complete CLI syntax, concrete keyed success/failure contracts, and validation gates (secret-pattern refusal, doctor row) with no wasted tokens. The weak spot is navigation — several section-anchored references point outside the skill's own directory and are absent from the bundle, leaving those details unreachable from this skill alone.

Suggestions

Ship the frequently cited files (schemas/journal.md sections on parent pointers and the status record, references/secret-value.ere) inside the slack skill's own references/ directory, or inline the few lines of each that the rules depend on.

Include one or two worked command examples with realistic arguments (e.g. a post with --mention and --thread) alongside the usage synopsis to make the common cases copy-paste ready.

Add a short ordered 'first run' sequence (setup -> install -> listen) so the operator flow is explicit rather than inferred from the Rules section.

DimensionReasoningScore

Conciseness

The body is maximally lean: no padding, no explanation of concepts Claude already knows, and every rule states a concrete behavioral contract (e.g. "A match is refused, journaled and never sent", "A plain restart drops a removed owner but never invites an added one"). This matches the 'lean and efficient; every token earns its place' anchor; there is nothing to trim without losing information.

5 / 5

Actionability

The opening code block gives the full executable CLI synopsis with all flags, and rules cite concrete keyed outputs and exit codes ("delivered", "text-too-long", "text-not-literal", "exits 0", "exit 2") plus `slack --help` for full detail. It sits at 'mostly executable guidance; minor gaps' rather than 5 because no worked example invocations with real values are shown, only the usage synopsis.

4 / 5

Workflow Clarity

The verb set implies a clear sequence (setup binds and installs, listen runs the relay, post sends, listen --status diagnoses), and error/validation checkpoints are explicit: keyed failure causes with retry-on-next-poll, the secret-pattern refusal gate before any send, and a `fix=` field on every non-ok status line. It is not 5 because the sequence must be inferred from the rules rather than being laid out as ordered steps with explicit recovery loops.

4 / 5

Progressive Disclosure

The overview appropriately defers detail to `slack --help` and section-anchored links, but the actual bundle contains only scripts/ — the referenced paths schemas/journal.md, references/secret-value.ere, kendex.settings.toml.example, and the ../orch and ../communication references do not exist in this skill's directory, so a reader cannot navigate them from the bundle alone. This fits 'some structure; references present but not fully resolvable/organized' better than the 4 anchor's 'minor organization gaps'.

3 / 5

Total

16

/

20

Passed

Description

66%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 specific, niche-scoped description with strong natural triggers for Slack posting and relay operation. Its main weakness is the absence of any explicit 'use when' guidance, which caps completeness and leaves invocation conditions implied rather than stated.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to send something to Slack, check or restart the Slack relay, or bind a checkout's mailbox to a Slack channel.'

Mention the read verb (reading channel history) so the description covers all user-facing capabilities, not just setup and posting.

Consider naming the natural user phrases ('send to Slack', 'Slack notification') among the triggers to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "bind an overseer's mailbox to a private Slack channel", "run or check the relay", "post an alert or a file to Slack" — which matches the 'several specific actions; minor gaps' anchor. It falls short of 5 because the read, compact, and install verbs are not mentioned, leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clear (bind, run/check the relay, post alerts/files), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only weakly implied by the imperative "Load to...". Per the judging guideline, a missing explicit trigger clause caps completeness at 3, and it does not reach 4 because the when-side is implied rather than stated at all.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "Slack", "post", "alert", "file", "channel", "relay". It fits the 'good keyword coverage; a few natural terms missing' anchor rather than 5, since common phrasings like "send a message to Slack", "notify", or "DM" are absent and "overseer's mailbox" is ecosystem jargon rather than a user-natural term.

4 / 5

Distinctiveness Conflict Risk

The mailbox-relay/overseer framing carves a clear niche with distinctive triggers ("overseer's mailbox", "relay", "private Slack channel"), fitting 'mostly distinct; minor overlap risk'. It is not 5 because the generic trigger "post an alert or a file to Slack" could overlap with a general Slack-messaging skill in the same checkout.

4 / 5

Total

15

/

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

.agents/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.