CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

slack

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

62

Quality

78%

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

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.

A strong, dense instruction-only skill: concrete tool-call examples, an exact HTTP fallback, and unusually thorough validation and error-recovery guidance (schema-rejection correction, delivery-state inspection, retry-key preservation, approval gates). The main improvements are trimming cross-section repetition, giving one full argument example for a common write, and splitting some policy detail into reference files so SKILL.md reads more like an overview.

Suggestions

Consolidate the delivery/mirroring rules that appear in both "Collaboration and delivery" and "Tasks and routines" to remove repetition and tighten conciseness.

Add one complete argument example for the most common write path (slack_post_message after slack_open_dm), mirroring the existing slack_search example.

Move secondary policy detail (delivery-state semantics, Slack-linked mirroring behavior, routine scheduling rules) into a reference file so SKILL.md stays a lean overview with clearly signaled one-level references.

DimensionReasoningScore

Conciseness

The body is dense, policy-style instruction with no padding or explanation of concepts Claude already knows — every section adds Paperclip/Slack-specific rules. It is not a 5 because some guidance repeats across sections (delivery and mirroring rules appear in both "Collaboration and delivery" and "Tasks and routines") and a few sentences could be tightened.

4 / 5

Actionability

Mostly executable guidance: the HTTP POST spec with exact env-var headers and body, the slack_search example {"channels":["C012AB3CD"],"query":"launch decision","limit":10}, the UUID idempotencyKey example, and the slack_open_dm → slack_post_message sequence. Minor gaps remain — e.g. no argument example for the most common write (slack_post_message), though schemas are delegated to TOOLS.json, which the scoring notes treat as acceptable for an instruction-only skill.

4 / 5

Workflow Clarity

Sequences are clear with explicit validation and feedback loops: "A schema rejection happens before execution: correct the arguments against the tool schema", "Inspect the returned delivery state. Queued or uncertain is not delivered; do not retry an uncertain mutation with a new key", approval gates for destructive operations, and pagination loops ("Fetch further history/thread pages when needed"). This matches the anchor-5 pattern of explicit validation steps with error-recovery loops.

5 / 5

Progressive Disclosure

Good structure: four clear sections and one clearly signaled one-level-deep external reference ("Read the adjacent TOOLS.json file for every operation's exact argument schema") that properly externalizes argument schemas. It is not a 5 because the ~85-line body is itself the full policy document rather than a concise overview — detail like delivery-state semantics, mirroring rules, and routine behavior could live in reference files to keep SKILL.md an overview.

4 / 5

Total

17

/

20

Passed

Description

65%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 identifies a clear, distinct niche (Slack bot operations within Paperclip tasks/routines) with decent natural keywords, but it lacks any "Use when..." trigger clause and leans on the generic verb "collaborate" instead of naming more of the concrete operations the body actually supports (search, DM, post, upload). It reads more like a scope statement than a triggerable description.

Suggestions

Add an explicit trigger clause, e.g. "Use when reading or posting in Slack from a Paperclip task, routine, or Slack-origin conversation," to satisfy the missing "when" half of completeness.

Replace the generic "collaborate" with concrete operations users would name, such as "search messages, send DMs, post replies, upload files, and manage canvases/pins."

Include common natural phrasings users actually say — "Slack message", "channel", "DM", "thread" — to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"read shared discussions" is a concrete action, but "collaborate" is generic and no other specific operations (send messages, search, upload) are named. This matches anchor 3 (domain plus 1-2 concrete actions); it does not list the several specific actions required for anchor 4.

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, capping completeness at 3 per the judging guidelines. It is not a 2 because the what-clause is clear, not vague.

3 / 5

Trigger Term Quality

Natural terms like "Slack bot", "Slack conversations", "Paperclip tasks", "routines", and "shared discussions" give good keyword coverage. Anchor 5 is not earned because common user phrasings such as messages, channels, and DMs are absent.

4 / 5

Distinctiveness Conflict Risk

"assigned Slack bot from Slack conversations, Paperclip tasks, and routines" carves a clear niche with distinct triggers; minimal risk of triggering for an unrelated skill. The vague "collaborate" alone would risk overlap, but the Slack/Paperclip framing keeps it anchored at 5.

5 / 5

Total

15

/

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

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.