Skip to content

workiq skill: use prefixed MCP tool name #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
johnmog wants to merge 1 commit into
base: main
Choose a base branch
from
Open

workiq skill: use prefixed MCP tool name #41

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 39 additions & 37 deletions plugins/workiq/skills/workiq/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,18 +15,18 @@ WorkIQ connects AI agents to Microsoft 365 Copilot, providing access to workplac

| User Question Pattern | Example | Action |
|-----------------------|---------|--------|
| What someone said/shared/communicated | "What did Rob say about X?" | `ask_work_iq` |
| Someone's priorities/concerns/focus | "What's top of mind for Sarah?" | `ask_work_iq` |
| Meeting content/decisions/action items | "What was decided in yesterday's meeting?" | `ask_work_iq` |
| Email content or conversations | "Any emails from John about the deadline?" | `ask_work_iq` |
| Teams messages or chats | "What did the team discuss about the release?" | `ask_work_iq` |
| Document locations or content | "Where is the design doc?" | `ask_work_iq` |
| Colleague expertise or ownership | "Who owns the billing system?" | `ask_work_iq` |
| Calendar/schedule information | "What meetings do I have today?" | `ask_work_iq` |
| Organizational context | "What are the team's Q1 goals?" | `ask_work_iq` |
| Project status or updates | "What's the status of Project X?" | `ask_work_iq` |
| Team activities or work | "What is the team working on?" | `ask_work_iq` |
| Any workplace/work-related context | "Any updates I should know about?" | `ask_work_iq` |
| What someone said/shared/communicated | "What did Rob say about X?" | `workiq-ask_work_iq` |
| Someone's priorities/concerns/focus | "What's top of mind for Sarah?" | `workiq-ask_work_iq` |
| Meeting content/decisions/action items | "What was decided in yesterday's meeting?" | `workiq-ask_work_iq` |
| Email content or conversations | "Any emails from John about the deadline?" | `workiq-ask_work_iq` |
| Teams messages or chats | "What did the team discuss about the release?" | `workiq-ask_work_iq` |
| Document locations or content | "Where is the design doc?" | `workiq-ask_work_iq` |
| Colleague expertise or ownership | "Who owns the billing system?" | `workiq-ask_work_iq` |
| Calendar/schedule information | "What meetings do I have today?" | `workiq-ask_work_iq` |
| Organizational context | "What are the team's Q1 goals?" | `workiq-ask_work_iq` |
| Project status or updates | "What's the status of Project X?" | `workiq-ask_work_iq` |
| Team activities or work | "What is the team working on?" | `workiq-ask_work_iq` |
| Any workplace/work-related context | "Any updates I should know about?" | `workiq-ask_work_iq` |

**DO NOT say "I don't have access to emails/meetings/messages"** - use WorkIQ instead!

Expand All @@ -38,84 +38,86 @@ Authentication is automatic with the connected user's credentials.

## MCP Tool

Use the `ask_work_iq` MCP tool to query Microsoft 365 Copilot. The tool accepts a single `question` parameter.
Use the `workiq-ask_work_iq` MCP tool to query Microsoft 365 Copilot. The tool accepts a single `question` parameter.

> The MCP server is named `workiq`, so the tool is exposed to the agent as `workiq-ask_work_iq` (server name + `-` + tool name). Calling the bare `ask_work_iq` will fail with `Tool 'ask_work_iq' does not exist.`

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "<your question>" }` |
| `workiq-ask_work_iq` | `{ "question": "<your question>" }` |

## Quick Start

Query M365 Copilot using the MCP tool:

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Who is the expert on TypeSpec?" }` |
| `workiq-ask_work_iq` | `{ "question": "Who is the expert on TypeSpec?" }` |

## Common Use Cases

### What Someone Is Thinking/Sharing

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "What are the latest top of mind from Rob I should be aware of?" }` |
| `ask_work_iq` | `{ "question": "What has Sarah been focused on lately?" }` |
| `ask_work_iq` | `{ "question": "What did John share about the project?" }` |
| `ask_work_iq` | `{ "question": "What concerns has my manager raised recently?" }` |
| `workiq-ask_work_iq` | `{ "question": "What are the latest top of mind from Rob I should be aware of?" }` |
| `workiq-ask_work_iq` | `{ "question": "What has Sarah been focused on lately?" }` |
| `workiq-ask_work_iq` | `{ "question": "What did John share about the project?" }` |
| `workiq-ask_work_iq` | `{ "question": "What concerns has my manager raised recently?" }` |

### Find Experts and People

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Who is the expert on authentication in our team?" }` |
| `ask_work_iq` | `{ "question": "Who should I talk to about the billing system?" }` |
| `ask_work_iq` | `{ "question": "Who worked on the checkout feature?" }` |
| `workiq-ask_work_iq` | `{ "question": "Who is the expert on authentication in our team?" }` |
| `workiq-ask_work_iq` | `{ "question": "Who should I talk to about the billing system?" }` |
| `workiq-ask_work_iq` | `{ "question": "Who worked on the checkout feature?" }` |

### Retrieve Meeting Context

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "What decisions were made in my meeting last week about the new feature?" }` |
| `ask_work_iq` | `{ "question": "Summarize the architecture discussion from yesterday's standup" }` |
| `ask_work_iq` | `{ "question": "What action items came out of the sprint planning?" }` |
| `workiq-ask_work_iq` | `{ "question": "What decisions were made in my meeting last week about the new feature?" }` |
| `workiq-ask_work_iq` | `{ "question": "Summarize the architecture discussion from yesterday's standup" }` |
| `workiq-ask_work_iq` | `{ "question": "What action items came out of the sprint planning?" }` |

### Find Emails and Messages

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Any recent emails from Rob about the deadline?" }` |
| `ask_work_iq` | `{ "question": "What did the team discuss in Teams about the release?" }` |
| `ask_work_iq` | `{ "question": "Summarize my unread messages from today" }` |
| `workiq-ask_work_iq` | `{ "question": "Any recent emails from Rob about the deadline?" }` |
| `workiq-ask_work_iq` | `{ "question": "What did the team discuss in Teams about the release?" }` |
| `workiq-ask_work_iq` | `{ "question": "Summarize my unread messages from today" }` |

### Locate Documents and Specs

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Find the design doc for the authentication system" }` |
| `ask_work_iq` | `{ "question": "What's the latest spec for Project X?" }` |
| `ask_work_iq` | `{ "question": "Where is the API documentation for the payments service?" }` |
| `workiq-ask_work_iq` | `{ "question": "Find the design doc for the authentication system" }` |
| `workiq-ask_work_iq` | `{ "question": "What's the latest spec for Project X?" }` |
| `workiq-ask_work_iq` | `{ "question": "Where is the API documentation for the payments service?" }` |

### Understand Priorities

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Based on discussions with my manager, what are my top priorities?" }` |
| `ask_work_iq` | `{ "question": "What are the team's goals for this quarter?" }` |
| `ask_work_iq` | `{ "question": "What's blocking the release?" }` |
| `workiq-ask_work_iq` | `{ "question": "Based on discussions with my manager, what are my top priorities?" }` |
| `workiq-ask_work_iq` | `{ "question": "What are the team's goals for this quarter?" }` |
| `workiq-ask_work_iq` | `{ "question": "What's blocking the release?" }` |

### Ground Implementation in Context

When implementing features, use WorkIQ to ground your work in organizational knowledge:

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Based on the latest spec for Project X, what are the backend requirements?" }` |
| `workiq-ask_work_iq` | `{ "question": "Based on the latest spec for Project X, what are the backend requirements?" }` |

Then implement based on the response.

## MCP Tool Reference

### ask_work_iq
### `workiq-ask_work_iq`

Query Microsoft 365 Copilot for workplace intelligence.

Expand All @@ -127,4 +129,4 @@ Query Microsoft 365 Copilot for workplace intelligence.

| Tool | Parameters |
|------|------------|
| `ask_work_iq` | `{ "question": "Who is my manager?" }` |
| `workiq-ask_work_iq` | `{ "question": "Who is my manager?" }` |