workiq-copilot

# WorkIQ Copilot Skill

## Overview

WorkIQ (Public Preview) lets Copilot query Microsoft 365 data with natural language. It supports schedules, documents, Teams messages, email threads, follow-up tracking, stakeholder summaries, and more. Use this skill whenever a task needs live organizational intelligence beyond the local repository.

## Supported Data & Sample Prompts

- **Emails** – “Summarize emails from Sarah about the budget.”
- **Meetings** – “What are my upcoming meetings this week?”
- **Documents** – “Find recent documents about Q4 planning.”
- **Teams** – “Summarize messages in the Engineering channel today.”
- **People/Projects** – “Who is working on Project Alpha?”

## Getting Access

1. **Copilot CLI plugin (preferred)**
   - `copilot`
   - `/plugin marketplace add github/copilot-plugins`
   - `/plugin install workiq@copilot-plugins`
   - Restart Copilot CLI.
2. **Standalone CLI / MCP server**
   - `npm install -g @microsoft/workiq` (or `npx -y @microsoft/workiq mcp`).
   - Run `workiq mcp` to expose MCP tools if needed.
3. **Tenant consent**
   - First use prompts for Microsoft 365 admin consent (EULA + permissions). Non-admins must contact tenant admin to approve per the Tenant Administrator Enablement Guide.

## Pre-flight Checklist

- Run `Get-Command workiq` to ensure the binary is available.
- Accept the EULA once via `workiq accept-eula`.
- Confirm the correct tenant (`-t <tenant-id>` if different from default `common`).
- Be ready to complete device login in the browser when prompted.

## Core Workflow

1. **Clarify intent** – agenda, action items, document lookup, people search, risk summary, etc.
2. **Craft precise prompt** – include timeframe, source, or topic (e.g., “Summarize Teams posts in #eng for today”).
3. **Run command** – `workiq ask --question "<prompt>"` (use `-q` for shorthand if desired).
4. **Monitor execution** – long answers may stream; wait for the response to finish before issuing additional requests.
5. **Summarize & reda