diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/calendar/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/calendar/description.md
index 43865ef53..e78c81eb2 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/calendar/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/calendar/description.md
@@ -1 +1,3 @@
-Use for calendar planning and scheduling: check availability, read event details, create events, and update events.
+Specialist for events on the user's calendar.
+Use proactively when the user wants to check availability, create, reschedule, RSVP to, or remove a calendar event.
+Meeting invitations that reserve a time slot belong here.
diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/gmail/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/gmail/description.md
index db5614805..e0426abf5 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/gmail/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/gmail/description.md
@@ -1 +1,3 @@
-Use for Gmail inbox actions: search/read emails, draft or update replies, send messages, and trash emails.
+Specialist for messages in the user's Gmail inbox.
+Use proactively when the user wants to search, read, send, reply to, archive, star, label, or trash an email.
+Email-only conversations belong here, including discussions about meetings that do not reserve a time slot.
diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/jira/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/jira/description.md
index 2cd7e082a..2d80b08b7 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/jira/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/jira/description.md
@@ -1 +1,2 @@
-Use for Jira issue/project workflows: search issues, inspect fields, update tickets, and move work through workflow states.
+Specialist for issues and projects in the user's Jira.
+Use proactively when the user wants to find a Jira issue, change its fields, assign it, or transition it between workflow states.
diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/linear/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/linear/description.md
index 6ad02c788..1f2a2f410 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/linear/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/linear/description.md
@@ -1 +1,2 @@
-Use for Linear issue/project work: find/create issues, update status/assignees, review project progress, and inspect cycles.
+Specialist for issues, projects, and cycles in the user's Linear workspace.
+Use proactively when the user wants to find, create, triage, assign, or close a Linear issue, or progress a cycle.
diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/notion/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/notion/description.md
index f1d51c18a..9a02c7561 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/notion/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/notion/description.md
@@ -1 +1,2 @@
-Use for Notion workspace pages: create pages, update page content, and delete pages.
+Specialist for pages in the user's Notion workspace.
+Use proactively when the user wants to create, change, archive, or remove a Notion page.
diff --git a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/slack/description.md b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/slack/description.md
index 246f79dfe..6fee5e74b 100644
--- a/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/slack/description.md
+++ b/surfsense_backend/app/agents/multi_agent_chat/subagents/connectors/slack/description.md
@@ -1 +1,2 @@
-Use for Slack channel communication: read channel/thread history, summarize conversations, and post replies.
+Specialist for messages in the user's Slack channels and threads.
+Use proactively when the user wants to read or summarize a Slack conversation, post a Slack message, or react in a thread.