CtrlK
BlogDocsLog inGet started
Tessl Logo

slack

Use the assigned Slack bot from Slack conversations, Paperclip tasks, and routines to read shared discussions and collaborate.

60

Quality

70%

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/slack/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 content is a lean, highly operational guide with concrete examples (endpoint URLs, JSON payloads, a UUID, exact tool sequences) and meaningful validation checkpoints for delivery, schema rejection, and destructive operations. Its main weaknesses are slight redundancy across sections and a TOOLS.json reference that does not exist in the bundle.

DimensionReasoningScore

Conciseness

The body is dense, operational prose that assumes Claude's competence and explains no general concepts — every section carries policy or concrete mechanics. It is not quite a 5 because a few rules are stated twice (schema-rejection handling appears in both the search and delivery sections, and the private-channel guidance spans three overlapping sentences), so it could be tightened further.

4 / 5

Actionability

Guidance is copy-paste ready: the exact HTTP endpoint with environment variables and headers, a concrete JSON payload shape, a full `slack_search` call example ("{\"channels\":[\"C012AB3CD\"],\"query\":\"launch decision\",\"limit\":10}"), a valid idempotency UUID example, and a concrete two-step recipe for "send me a Slack message" (slack_open_dm then slack_post_message). This matches anchor 5: fully executable examples covering the common cases.

5 / 5

Workflow Clarity

Sequences are clear and include real checkpoints: the read flow (supplied channel, else slack_channels, then paginate history/threads, "Fetch further history/thread pages when needed"), schema rejection treated as a correct-the-arguments-and-retry feedback loop, approval required before destructive operations, and "Inspect the returned delivery state. Queued or uncertain is not delivered; do not retry ... with a new key." It falls short of anchor 5 because the workflows are described across prose sections rather than as explicit ordered checklists, and some validation steps are implicit.

4 / 5

Progressive Disclosure

The body is well-sectioned (Read and act, Collaboration and delivery, Tasks and routines) and pushes per-operation argument schemas to a clearly signaled, one-level-deep reference ("Read the adjacent TOOLS.json file for every operation's exact argument schema") rather than inlining an API reference. It is not a 5 because that referenced TOOLS.json is not present in this skill bundle, so the navigation path cannot actually be followed as shipped; the structure itself otherwise matches anchor 4 (good structure, references mostly clear, minor gaps).

4 / 5

Total

17

/

20

Passed

Description

57%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 is distinctive and unambiguous about its Slack/Paperclip niche, but it under-sells the skill's actual capabilities. It states only one concrete action and provides no explicit "Use when..." trigger guidance or natural trigger phrases like "Slack message", "channel", or "DM".

Suggestions

Add an explicit 'Use when...' clause, e.g. "Use when the user asks to read or send Slack messages, search channel history, or collaborate in a linked Slack workspace."

Enumerate concrete actions in place of the generic "collaborate": send messages and files, search channel history, manage reactions, pins, canvases, and DMs.

Include natural user phrasings such as "Slack message", "channel", "DM", and "thread" so the description triggers on how users actually ask for this.

DimensionReasoningScore

Specificity

"Use the assigned Slack bot ... to read shared discussions and collaborate" names the domain (Slack bot, Slack conversations, Paperclip tasks, routines) but offers only one concrete action ("read shared discussions") while "collaborate" is generic. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several specific actions such as send messages, search history, or manage canvases.

3 / 5

Completeness

The "what" is stated (use the assigned Slack bot to read shared discussions and collaborate) but there is no "Use when..." clause or equivalent explicit trigger guidance; usage is only weakly implied by "from Slack conversations, Paperclip tasks, and routines". Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; the what is clear so it is not a 2.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Slack bot", "Slack conversations", "Paperclip tasks", "routines", "read shared discussions") but common natural phrasings users would say — "Slack message", "channel", "DM", "search Slack" — are missing. This fits anchor 3 (some relevant keywords but missing common variations or synonyms), not 4's fuller keyword coverage.

3 / 5

Distinctiveness Conflict Risk

"Use the assigned Slack bot from Slack conversations, Paperclip tasks, and routines" carves out a clear niche tied to a specific platform (Slack) and harness (Paperclip), making conflict with other skills minimal. It clearly matches anchor 5 (clear niche with distinct triggers); the neighboring anchor 4 reserves overlap risk with closely related skills, which does not apply here.

5 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
paperclipai/paperclip
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.