CHATBOTS
/improvedocs: draft a ReadMe edit and open a GitHub PR
When a teammate runs /improvedocs in Slack with a correction, the agent finds the relevant ReadMe page, drafts the revised Markdown.
How it runs
The automated pipeline, trigger to output.
- TriggerSlack /improvedocs slash command receivedSlack
- ActionFind target page via ReadMe searchReadMe
- ActionDraft revised Markdown section with OpenAIOpenAI
- LogicConfirm single page matched before PR
- ActionOpen GitHub pull request with the editGitHub
- OutputPost PR link to SlackSlack
What it does
Turns a casual Slack correction into a reviewable docs change. A user runs `/improvedocs` describing what's wrong or missing; the agent locates the right ReadMe page, generates a clean Markdown edit grounded in the existing content, and opens a GitHub pull request in your docs-as-code repo. Nothing publishes automatically — a human approves the PR.
When to use it
When your ReadMe docs are synced from a Git repo and you want frontline staff to propose fixes without learning Git. Ideal for capturing tribal knowledge the moment someone spots a stale or wrong page.
How it works
- 1Slack sends the `/improvedocs` slash-command text to the webhook.
- 2ReadMe search identifies the page most likely needing the change.
- 3OpenAI rewrites the relevant section as a focused Markdown diff.
- 4A logic step confirms a single target page was matched before proceeding.
- 5A GitHub pull request is opened with the edit and the requester's note.
- 6The bot posts the PR link back to Slack for review.
Set it up
What you configure once, before turning it on.
- 1Connect SlackChannels, DMs, threads, mentions.
- 2Connect ReadMeAPI docs, changelog, auth.
- 3Connect OpenAIModels, embeddings, files.
- 4Connect GitHubRepos, issues, pull requests, actions.
- 5Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
- 6Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
- 7Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.
More Chatbots workflows
Discord WAF False-Positive Triage from Ray ID
When a user posts a Cloudflare ray ID in a Discord support channel, the bot looks up the blocked request's WAF event, classifies whether it looks like a genuine false positive.
Agentic WAF Investigator with Discord Approval Gate
An autonomous agent investigates a Discord-reported WAF block end to end: pulls Cloudflare logs, correlates with PagerDuty incidents, decides if an allowlist is safe.
Discord Onboarding Completion to CRM Sync
The moment a member finishes Discord onboarding, captures their submitted profile answers, creates or updates a contact in HubSpot.
Draft WAF Allowlist Proposal to Linear from Discord Report
Lets a support engineer confirm a Discord WAF report is a false positive, then auto-drafts a scoped Cloudflare allowlist rule proposal and files it as a Linear ticket…
Discord FAQ Free-Text Answer Grader
When a member submits a free-text answer in their onboarding thread, an agent grades it against the canonical FAQ knowledge base, replies with targeted feedback.
Discord FAQ-Gated Role Concierge
Greets each new Discord member in a private onboarding thread, walks them through required FAQ steps one at a time.
Run it inside a business
This workflow drops into a full company template. Import the org, and this is one of the playbooks its agents run.

Run this workflow in your colony.
14-day trial. No DevOps. No Sales call. Provisioned in under a minute.
