From eae0e9b558abe9e3eba044f370db79178d756a22 Mon Sep 17 00:00:00 2001 From: Jinjing <6427696+AmethystLiang@users.noreply.github.com> Date: Wed, 20 May 2026 20:03:56 -0700 Subject: [PATCH] docs: trim file upload examples --- README.md | 10 ---------- skills/agent-slack/SKILL.md | 5 +---- skills/agent-slack/references/commands.md | 6 +----- 3 files changed, 2 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 8ef227f..a81c350 100644 --- a/README.md +++ b/README.md @@ -235,17 +235,7 @@ Attach options for `message send`: Upload files through `message send`: ```bash -# Upload a file without a message -agent-slack message send "#general" --attach ./report.md - -# Upload with an initial comment agent-slack message send "#general" "Coverage report" --attach ./report.md - -# Upload into a thread -agent-slack message send "https://workspace.slack.com/archives/C123/p1700000000000000" --attach ./report.md - -# Upload multiple files -agent-slack message send "#general" "Reports" --attach ./report.md --attach ./data.csv ``` Example — post a message with a native Slack table block: diff --git a/skills/agent-slack/SKILL.md b/skills/agent-slack/SKILL.md index 767fe49..cd2e98e 100644 --- a/skills/agent-slack/SKILL.md +++ b/skills/agent-slack/SKILL.md @@ -164,13 +164,10 @@ Attach options for `message send`: - `--attach ` upload a local file (repeatable; message text is optional when attaching files) - `--blocks ` send raw [Block Kit](https://docs.slack.dev/block-kit/) blocks from a JSON file (or `-` for stdin). Enables headers, dividers, table blocks, and other structured layouts. Incompatible with `--attach`. -File upload examples: +File upload example: ```bash -agent-slack message send "general" --attach ./report.md agent-slack message send "general" "Coverage report" --attach ./report.md -agent-slack message send "https://workspace.slack.com/archives/C123/p1700000000000000" --attach ./report.md -agent-slack message send "general" "Reports" --attach ./report.md --attach ./data.csv ``` `message send` returns `channel_id` plus the posted `ts` and a `permalink` (for non-attachment sends). `thread_ts` appears only when replying in a thread. diff --git a/skills/agent-slack/references/commands.md b/skills/agent-slack/references/commands.md index 3b0466b..a02f586 100644 --- a/skills/agent-slack/references/commands.md +++ b/skills/agent-slack/references/commands.md @@ -64,11 +64,7 @@ Run `agent-slack --help` (or `agent-slack --help`) for the full option - Otherwise posts to the channel/DM. - `[text]` is optional when uploading files with `--attach`; when present, it becomes the initial comment on the first uploaded file. - Bullet lists (`- `, `* `, `• `, `1. `, etc.) are automatically converted to Slack’s native rich text format, so recipients see real editable bullets instead of plain-text dashes. - - Examples: - - `agent-slack message send "general" --attach ./report.md` - - `agent-slack message send "general" "Coverage report" --attach ./report.md` - - `agent-slack message send "https://workspace.slack.com/archives/C123/p1700000000000000" --attach ./report.md` - - `agent-slack message send "general" "Reports" --attach ./report.md --attach ./data.csv` + - Example: `agent-slack message send "general" "Coverage report" --attach ./report.md` - Options: - `--workspace ` (needed for channel _names_ across multiple workspaces) - `--thread-ts .` (optional, channel mode only)