Agent skill

Block Kit

by openclaw in openclaw/openclaw

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

MITAuto-check passed

Install Block Kit

skills CLI
$ npx skills add openclaw/openclaw --skill block-kit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openclaw/openclaw block-kit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openclaw/openclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/slack/skills/block-kit .claude/skills/block-kit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
block-kit
GitHub stars
392k
Token cost
~624 tokens
SKILL.md length
329 words
Files
3 (incl. references)
Skills in repo
93
Repo updated
First seen
Licence
MIT

At a glance

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

  • SKILL.md covers Choose the surface, Send the result and Native Block Kit authoring
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Block Kit is an agent skill from openclaw/openclaw. Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/official-block-kit.md` and `references/official-common-patterns.md`).

It works with Slack. The repository describes itself as: The AI that really does things. Any OS. Any Platform. The lobster way. 🦞. The licence is MIT.

Example prompts

  • “/block-kit”

Requirements

  • Pre-approved tools (allowed-tools): message

What it can do on your machine

Read from SKILL.md and the folder at commit 1eb5970. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • message

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Block Kit loads about 624 tokens when it runs, and up to ~7.4k if it reads all its reference files. Until then it costs about 34 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~624
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openclaw/openclaw at commit 1eb5970, republished under its MIT licence (© openclaw). 329 words, ~624 tokens.

Download SKILL.mdSave it as .claude/skills/block-kit/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
block-kit
description
Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.
allowed-tools
message

Slack Block Kit

Make useful Slack replies feel native. When structure or one-click follow-up improves the outcome, send a rich message without waiting for the user to ask for Block Kit.

Choose the surface

Use a presentation when the reply has at least one of these shapes:

  • a decision, confirmation, or next action that belongs on buttons or a select
  • a status, comparison, report, or plan that scans better as titled sections, a table, or a chart
  • important context that should be visually separated from the primary result

Use plain text for short answers and casual conversation where structure adds no value.

Send the result

For a reply in Slack, call the message tool with action: "send" and a portable presentation. The Slack plugin renders it as native Block Kit. Use the exact schema exposed by the current tool; supported block types can include text, context, divider, buttons, select, chart, and table.

  • Put the outcome first. Keep titles, labels, and context concise.
  • Give interactive controls real follow-up semantics. Use typed callback actions for conversational choices and url for an external destination. Do not use generic command actions for Slack controls; Slack renders them as text fallback rather than clickable controls.
  • Include a useful message fallback that preserves the meaning without the rich layout.
  • After the visible send succeeds, do not repeat the same content in the final response.

A control is complete only when its value is self-contained enough for the next agent turn to understand and act on. When an interaction returns, acknowledge the choice visibly and continue the requested workflow.

Native Block Kit authoring

When the user is building a Slack app or explicitly requests raw Block Kit JSON, read the adapted official Block Kit guide in full. For common message, modal, and App Home layouts, also read the official patterns.

Follow the adapted guide's live-documentation and blocks.validate workflow for native JSON. Do not pass native Slack blocks to OpenClaw's presentation field; the plugin owns that conversion.

© openclaw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in extensions/slack/skills/block-kit of openclaw/openclaw.

  • SKILL.md
  • references/official-block-kit.md
  • references/official-common-patterns.md

Open the folder on GitHubat commit 1eb5970

Compare with similar skills

Block Kit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Block Kit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Block Kit this skillopenclaw/openclaw392k—~624Automated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Slack GIF Creatoranthropics/skills180k29 repos~2kAutomated safety check: PassApache-2.0
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Electron App Automationvercel-labs/agent-browser44k5 repos~1.7kAutomated safety check: PassApache-2.0
Slack Browser Automationvercel-labs/agent-browser44k1 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Slack GIF Creator

    anthropics/skills

    Official

    Provides Slack size and frame limits, Python animation helpers and validators for building animated GIFs sized for emoji and messages.

    180k GitHub starsUsed in 29 repos~2k tokens
    Media & CreativeAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Electron App Automation

    vercel-labs/agent-browser

    Official

    Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.

    44k GitHub starsUsed in 5 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Slack Browser Automation

    vercel-labs/agent-browser

    Official

    Drives the Slack web app with the agent-browser CLI to check unread channels, search, read channel details and extract information, with screenshots as evidence.

    44k GitHub starsUsed in 1 repo~2.1k tokens
    Productivity & AutomationAuto-check passed
  • Composio

    ComposioHQ/composio

    Route and complete Composio work across Composio For You and Composio Platform.

    30k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed

More from openclaw/openclaw

All 93 skills in this repo
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Tmux

    openclaw/openclaw

    Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts.

    392k GitHub starsUsed in 2 repos~640 tokens
    Auto-check passed
  • Feishu Doc

    openclaw/openclaw

    Feishu document read/write workflows. An agent skill from openclaw/openclaw.

    392k GitHub stars~516 tokensUpdated today
    Auto-check passed
  • Openclaw PR Maintainer

    openclaw/openclaw

    Review, triage, repair, or land OpenClaw issues and pull requests with current-source evidence and the native maintainer workflow.

    392k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Browser Automation

    openclaw/openclaw

    A skill your agent uses when controlling web pages with the OpenClaw browser tool, especially multi-step flows, login checks, tab management, or recovery from stale refs/timeouts.

    392k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Clawsweeper

    openclaw/openclaw

    A skill your agent uses for all ClawSweeper work: OpenClaw issue/PR sweep reports, repair jobs, cloud fix PRs, @clawsweeper maintainer mention commands, trusted ClawSweeper-reviewed…

    392k GitHub stars~3k tokensUpdated today
    Auto-check passed

Works with

Questions about Block Kit

What does Block Kit do?

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON. Block Kit is an agent skill from openclaw/openclaw. Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

How do I install Block Kit in Claude Code?

Run `npx skills add openclaw/openclaw --skill block-kit -a claude-code`. Or copy the skill folder (extensions/slack/skills/block-kit in openclaw/openclaw) into .claude/skills/block-kit in your project. Claude Code loads it when a task matches its description.

How do I install Block Kit in Codex?

Run `npx skills add openclaw/openclaw --skill block-kit -a codex`. Or copy the skill folder (extensions/slack/skills/block-kit in openclaw/openclaw) into .agents/skills/block-kit in your project. Codex loads it when a task matches its description.

Can I use Block Kit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openclaw/openclaw --skill block-kit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/block-kit, .gemini/skills/block-kit, .github/skills/block-kit and .opencode/skills/block-kit in your project.

What does Block Kit need to run?

SKILL.md names no scripts, command-line tools or credentials: Block Kit is instructions for the agent only. Its frontmatter pre-approves these tools: message.

Does Block Kit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Block Kit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Block Kit use?

Block Kit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Block Kit use?

About 624 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.8k tokens, read only when the agent opens those files.

What are the alternatives to Block Kit?

Skills that share tags, products or a category with Block Kit: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Slack GIF Creator (anthropics/skills, 180k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars) and Electron App Automation (vercel-labs/agent-browser, 44k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Block Kit?

openclaw (a GitHub organization) maintains it in openclaw/openclaw, which has 391,610 GitHub stars. The repository holds 93 skills in this directory. The repository was last updated on October 8, 2026.

Source: openclaw/openclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.