slack_report

---
name: slack_report
description: Share markdown reports to the user's configured Slack agent_cli_report channel via Fastfold API, and persist the markdown as a library item.
---

# Slack Report Share

## Overview

Use this skill to send markdown reports to Slack through the Fastfold Cloud backend endpoint:

- `POST /v1/slack/messages/agent-cli-report`

The endpoint posts to the configured `agent_cli_report` Slack channel and stores the same markdown as a library markdown item.

## Authentication

- Resolve key in this order:
  1. `FASTFOLD_API_KEY` from environment
  2. FastFold CLI config `~/.fastfold-cli/config.json` (`api.fastfold_cloud_key`)
- Do not ask users to paste secrets into chat.
- If key is still missing:
  - Default guidance (generic agents): ask the user to set `FASTFOLD_API_KEY` in environment or `.env`.
  - Only if user is explicitly using FastFold CLI, you may suggest:
    - `fastfold setup`
    - `fastfold config set api.fastfold_cloud_key <key>`

## When to Use

- User asks to share/export a session report to Slack.
- User asks to send markdown summary to the team's report channel.
- User asks to save a report in the library and Slack in one step.

## Agent Workflow

1. Export or prepare markdown report content.
2. Call the helper script:
   - `python scripts/send_agent_cli_report.py --markdown-file <path>`
   - Do not replace this with ad-hoc Python `requests` code.
3. If response has `ok: false` and `needs_slack_setup: true`, tell user:
   - Configure Slack at [https://cloud.fastfold.ai/integrations/slack](https://cloud.fastfold.ai/integrations/slack)
   - Set a channel for `agent_cli_report`.
4. If response includes `library_item_id`, include this open link in the reply:
   - `https://cloud.fastfold.ai/code/<library_item_id>?from=library`

## Friendly Failure Message

If Slack is not configured, return a user-friendly instruction and include:

- [https://cloud.fastfold.ai/integrations/slack](https://cloud.fastfold.ai/integrations/slack)

## Resources

- API details: [references/api.md](references/api.md)