CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

slack-formatting

Format messages for Slack using mrkdwn syntax. Use when responding to Slack channels (folder starts with "slack_" or JID contains slack identifiers).

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 actionable, well-organized mrkdwn cheat sheet: exact syntax for every construct, explicit anti-patterns, and a realistic worked example, with a clear detection step up front. The main cost is redundancy — the 'Quick rules' section restates rules already covered twice, inflating token spend without adding information.

Suggestions

Delete the 'Quick rules' section — every one of its six rules is already stated in the formatting table and 'What NOT to use', cutting roughly 10% of the body.

Fold the 'Example message' into the reference sections or trim it, since it duplicates syntax already shown (bold, bullets, quote, emoji, link) in one place.

Consolidate the bullet-list guidance in 'Lists', 'What NOT to use', and 'Quick rules' into the single Lists section to remove the third repetition.

DimensionReasoningScore

Conciseness

The body is mostly lean tables and code blocks, but the same rules are stated three times: e.g., 'use *single asterisks*' appears in the styles table, again as 'NO **double asterisks** for bold' in What NOT to use, and again as Quick rule 1; the bullet-vs-numbered-list rule likewise appears in Lists, What NOT to use, and Quick rule 3. The 'Quick rules' section is almost entirely a restatement, matching the 'mostly efficient but could be tightened' anchor. Not a 2 because there is no concept-explanation padding; not a 4 because a whole redundant section could be cut.

3 / 5

Actionability

Every element has exact copy-paste-ready syntax: a styles table ('*text*', '_text_', '~text~'), literal link/mention formats ('<https://example.com|Link text>', '<@U1234567890>'), a full worked example message, and explicit anti-patterns ('NO [text](url) links'). This matches the 'fully executable; copy-paste ready; specific examples cover the common cases' anchor. Not a 4 because there are no gaps — the guidance is directly executable as written.

5 / 5

Workflow Clarity

This is a simple single-purpose skill: the sequence is 'detect Slack context (folder/JID check)' then 'apply the formatting reference'. The single action is unambiguous and the detection step is explicit, which the judging guidelines say can score 5 for simple skills. No destructive or batch operations exist, so the validation cap does not apply. Not a 4 because nothing in the flow is missing or implicit for the skill's scope.

5 / 5

Progressive Disclosure

No bundle files exist, and the content is a self-contained cheat sheet appropriately kept inline; sections (detection, formatting reference, anti-patterns, example) are well organized and navigable. It sits at the 'good structure; most content appropriately placed; minor organization gaps' anchor. Not a 5 because the body is ~90 lines (above the under-50-lines simple-skill allowance) and the example/quick-rules duplication means it could be split or trimmed for cleaner organization.

4 / 5

Total

17

/

20

Passed

Description

82%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: it states one concrete capability and pairs it with an explicit, machine-checkable trigger (folder prefix, JID identifiers). Its only weakness is thin capability enumeration — a reader cannot tell from the description alone whether it covers links, mentions, lists, or emoji.

Suggestions

Enumerate the formatting capabilities in the description (e.g., 'Apply mrkdwn bold, links, mentions, lists, and emoji') to lift specificity from one action to several.

Add natural trigger variations such as 'Slack message', 'Slack chat', or 'Slackbot' to widen keyword coverage.

DimensionReasoningScore

Specificity

"Format messages for Slack using mrkdwn syntax" names the domain (Slack/mrkdwn) and one concrete action (format messages). It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor — no enumeration of what formatting covers (styles, links, mentions, lists) as the level-4/5 examples do. Not a 4 because only a single generic action is listed; not a 2 because the domain and action are concrete, not minimal.

3 / 5

Completeness

"Format messages for Slack using mrkdwn syntax" explicitly states what the skill does, and "Use when responding to Slack channels (folder starts with "slack_" or JID contains slack identifiers)" gives a concrete, explicit when-clause with trigger phrases. This mirrors the level-5 anchor structure almost exactly. Not a 4 because the when-clause is fully explicit with concrete detection conditions, not merely present.

5 / 5

Trigger Term Quality

"Slack", "Slack channels", "mrkdwn", and the literal "slack_" folder prefix give good natural keyword coverage — a user needing this would say "Slack". Missing a few natural variations ("Slack message", "Slack chat", "Slackbot") and any file-extension equivalents, so it falls just short of the comprehensive-synonyms anchor at 5. Clear of 3 because multiple distinct relevant terms are present rather than only some.

4 / 5

Distinctiveness Conflict Risk

Slack mrkdwn formatting is a clear niche with distinct triggers (Slack channels, slack_ folder prefix, JID identifiers); it would not plausibly fire for other formatting or messaging skills. Matches the 'clear niche with distinct triggers; minimal conflict risk' anchor. Not a 4 because the trigger conditions are uniquely Slack-specific with no meaningful overlap with closely related skills.

5 / 5

Total

17

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

jbaruch/nanoclaw-telegram

Path

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