Tool Discovery Orient Bot Orient A70a8b60

---
name: tool-discovery
description: Guide for discovering and using MCP tools via the discover_tools meta-tool. Use this skill when asked to perform tasks that require finding the right tools, when you see only discover_tools in your available tools, when asked "what tools are available", "find tools for X", or when planning multi-step workflows across JIRA, Slack, WhatsApp, or Google Docs.
---

# Tool Discovery System

This MCP server uses a **discovery-based tool loading pattern** to reduce context overhead. Instead of loading all 35+ tools upfront, only the `discover_tools` meta-tool is exposed. Use it to find and load the specific tools needed for your task.

## Quick Reference

```
# List all categories
discover_tools({ mode: "list_categories" })

# Browse tools in a category
discover_tools({ mode: "browse", category: "jira" })

# Search by natural language
discover_tools({ mode: "search", query: "send slack message" })

# Search by intent
discover_tools({ mode: "search", intent: "check team blockers" })
```

## Tool Categories

| Category    | Tools | Use For                                          |
| ----------- | ----- | ------------------------------------------------ |
| `jira`      | 14    | Issues, sprints, blockers, SLA, weekly summaries |
| `messaging` | 4     | Slack DMs, channel messages, user lookup         |
| `whatsapp`  | 8     | Message history, contacts, groups, media         |
| `docs`      | 11    | Google Slides, Sheets, presentations             |
| `system`    | 2     | Health check, configuration                      |

## Workflow: Starting a Task

**Always discover tools before attempting to use them.**

1. Identify what you need to accomplish
2. Call `discover_tools` with appropriate mode
3. Review returned tool schemas
4. Execute the discovered tools

## Examples

### Example 1: Check Team Status

**Task:** "What are the blockers for the team?"

```
# Step 1: Find blocker-related tools
discover_tools({ mode: "search", query: "blockers" })
# Returns: ai_first_get_blockers

# Step 2: Use the discovered tool
ai_first_get_blockers({})
```

### Example 2: Weekly Summary

**Task:** "Give me a weekly summary of the team's progress"

```
# Step 1: Find weekly summary tools
discover_tools({ mode: "browse", category: "jira" })
# Returns: ai_first_get_weekly_summary, ai_first_get_completed_this_week, etc.

# Step 2: Get the summary
ai_first_get_weekly_summary({})
```

### Example 3: Notify Team on Slack

**Task:** "Send a message to the team channel about blockers"

```
# Step 1: Find messaging and blocker tools
discover_tools({ mode: "search", query: "send slack channel message" })
discover_tools({ mode: "search", query: "blockers" })

# Step 2: Get blockers and send message
ai_first_get_blockers({})
ai_first_slack_send_channel_message({ channel: "#orienter", message: "Current blockers: ..." })
```

### Example 4: Search WhatsApp History

**Task:** "Find messages about the project deadline"

```
# Step 1: Find WhatsApp tools
discover_tools({ mode: "browse", category: "whatsapp" })
# Returns: whatsapp_search_messages, whatsapp_get_conversation, etc.

# Step 2: Search messages
whatsapp_search_messages({ text: "project deadline" })
```

### Example 5: Update Presentation

**Task:** "Update the weekly presentation with completed JIRA issues"

```
# Step 1: Discover needed tools across categories
discover_tools({ mode: "browse", category: "jira" })   # For completed issues
discover_tools({ mode: "browse", category: "docs" })   # For slides

# Step 2: Execute workflow
ai_first_get_completed_this_week({})
ai_first_slides_update_weekly({ presentationUrl: "..." })
```

## Search Tips

- **Exact tool names** get highest scores: `discover_tools({ query: "ai_first_get_blockers" })`
- **Keywords** work well: `"blocker"`, `"sprint"`, `"slack"`, `"whatsapp"`
- **Intent phrases** find related tools: `"notify team about progress"`
- **Use limit** to reduce results: `discover_tools({ mode: "search", query: "message", limit: 5 })`

## Common Tool Names

Quick reference for frequently used tools:

**JIRA:**

- `ai_first_get_in_progress` - Current work
- `ai_first_get_blockers` - Blocked issues
- `ai_first_get_daily_digest` - Today's summary
- `ai_first_get_weekly_summary` - Week overview

**Messaging (Slack):**

- `ai_first_slack_send_dm` - Direct message
- `ai_first_slack_send_channel_message` - Channel post
- `ai_first_slack_get_channel_messages` - Read channel history

**WhatsApp:**

- `whatsapp_search_messages` - Search message history
- `whatsapp_get_conversation` - Get chat with contact
- `whatsapp_list_groups` - List groups