slack-file-upload

Upload images, GIFs, videos, and documents to Slack channels via the Slack API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shiftrepo/aws --skill slack-file-upload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slack-file-upload
Source: https://github.com/shiftrepo/aws/tree/main/HermesAgent/skills/skills/devops/slack-file-upload
Command: npx skills add https://github.com/shiftrepo/aws --skill slack-file-upload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Slack's send_message MEDIA attachments are not supported; this skill enables uploading files via Slack API to attach to channels, bypassing limitations.

Core Features & Use Cases

  • Direct file uploads: Upload images, GIFs, videos, and documents directly to Slack channels using the API.
  • Threaded posting support: Optionally post within a thread by supplying thread_ts (if supported; though the SKILL.md mentions thread_ts in example? It shows payload with thread_ts, so it's possible.)
  • Environment & token guidance: Token must be in the environment path as specified.

Quick Start

Upload a local file to a Slack channel using the provided bot token.

Frequently Asked Questions about slack-file-upload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload files to Slack channels via API when media attachments are not supported?

Slack API file uploads bypass unsupported media attachments by executing initialization, upload, and completion steps. This process attaches images, GIFs, videos, and documents directly to channels or optional threads using a bot token.

What Slack bot token scopes are required to upload images and videos to channels?

A bot token with the files:write scope is required to upload images and videos. The token must be stored as SLACK_BOT_TOKEN in the environment path at /root/.hermes/profiles/bedrock-slack/.env.

Can I post uploaded files directly into a specific Slack thread?

Yes, you can post uploaded files directly into a Slack thread by supplying the thread_ts parameter in your payload. This targets the specific thread within the channel during the upload process.

What is the process for sending documents to Slack channels using a bot token?

Sending documents to Slack channels using a bot token involves a three-step API flow: initialization, upload, and completion. This attaches documents directly to the targeted channel using the files:write scope.

Why does my Slack send_message media attachment fail and how can I bypass it?

Slack send_message media attachments fail because they are not supported. Bypass this limitation by using the Slack API to upload files directly to channels, which requires a bot token with the files:write scope.