CtrlK
BlogDocsLog inGet started
Tessl Logo

slack-notifications

Slack MCP integration for agent-to-human notifications and bi-directional communication. Use when agents need to post progress updates, request approvals, or read user responses via Slack channels and threads.

71

Quality

86%

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

86%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 lean, highly operational skill file that packs env setup, rate-limit strategy, tool signatures, and a complete dual-channel approval workflow into ~35 lines without a wasted token. The two soft spots are both at the posting boundary: the payload format for conversations_add_message is unspecified, and the 10-minute timeout path has no defined next step.

DimensionReasoningScore

Conciseness

The body is lean and dense: it never explains what Slack or MCP is, and every line carries operational specifics (env vars, scopes, rate limits, tool signatures, polling constants). It assumes Claude's competence, matching the anchor-5 example of every token earning its place.

5 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: named tools with parameter lists ('conversations_add_message — channel_id, payload, content_type, thread_ts'), required env vars, an exact message format ('⏳ Approval Required — TAS-42: <action>'), and explicit error checking ('Check the response for ok'). It falls short of anchor 5 because the payload/content_type structure for posting is never specified, leaving the most common write operation underspecified.

4 / 5

Workflow Clarity

The dual-channel approval workflow is a clear numbered sequence with explicit validation (check 'ok'/'error'), a feedback loop (poll conversations_replies every 30s, match approved/yes/go vs rejected/no/stop, post confirmation back into the thread), and session-end checkpoint recovery. It sits below anchor 5 because the outcome after the 10-minute poll timeout is undefined, and validation of read results (history/replies) is implicit. This is not a destructive or batch skill, so the cap-3 rule does not apply.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (Setup, Rate limits, Tools, Approvals) and a single clearly-signaled one-level-deep reference to channel mappings ('.opencastle/stack/notifications-config.md'), so no discovery is possible through nested references. Per the simple-skill guideline, this warrants a 5 with no external bundle files present.

5 / 5

Total

18

/

20

Passed

Description

87%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 the domain, three concrete capabilities, and an explicit 'Use when' clause with natural trigger phrases, all in third person with no fluff. The only shortfalls are minor gaps in capability coverage and a few missing colloquial synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('Slack MCP integration') and several concrete actions ('post progress updates, request approvals, or read user responses'). It lists multiple specific actions but is not fully comprehensive (e.g., thread management and channel resolution are implied rather than stated), matching anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both questions: what ('Slack MCP integration for agent-to-human notifications and bi-directional communication') and when ('Use when agents need to post progress updates, request approvals, or read user responses via Slack channels and threads') with concrete trigger phrases, matching anchor 5. The 'Use when...' clause is present, so the completeness cap does not apply.

5 / 5

Trigger Term Quality

Natural terms like 'Slack', 'notifications', 'progress updates', 'approvals', and 'channels and threads' cover the phrases a user would say when needing this skill. A few common variations (e.g., 'ping me on Slack', 'ask me in Slack', 'get my attention') are missing, so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

'Slack MCP integration' carves out a clear niche with distinct triggers (Slack-specific terms, agent-to-human notification framing); it is unlikely to trigger for an unrelated skill, matching anchor 5. Voice is third person throughout, so no penalty applies.

5 / 5

Total

18

/

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
monkilabs/opencastle
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.